> ## Documentation Index
> Fetch the complete documentation index at: https://docs.realtimelca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> REST API reference for the Real-Time LCA (Life Cycle Assessment) service

## Welcome

The Real-Time LCA REST API lets you authenticate users, manage building projects and project members, and retrieve LCA and EPD material data programmatically. This reference is generated from the service's OpenAPI specification and reflects the endpoints exposed by the Real-Time LCA platform.

<Card title="Real-Time LCA OpenAPI specification" icon="leaf" href="/api-reference/realtime-lca-openapi.yaml">
  View the OpenAPI specification file
</Card>

## Base URLs

The API surface is split across a few hosts depending on the resource you're working with:

| Host                                   | Purpose                                           |
| -------------------------------------- | ------------------------------------------------- |
| `https://api.realtimelca.com/rest/api` | Primary REST API (projects, users, building data) |
| `https://api.realtimelca.com/epd/api`  | EPD (Environmental Product Declaration) service   |
| `https://auth.realtimelca.com`         | Frontegg identity and authentication              |
| `https://hasura.realtimelca.com`       | Hasura GraphQL endpoint                           |

## Authentication

All protected endpoints are authenticated using Bearer tokens.

To obtain a token, send a `POST /user` request to the authentication host with your Real-Time LCA credentials:

```json theme={null}
{
  "email": "you@example.com",
  "password": "your-password"
}
```

A successful (`200 OK`) response returns a bearer token. Include it on subsequent requests via the `Authorization` header:

```
Authorization: Bearer <token>
```

Protected endpoints declare the requirement in the spec as:

```json theme={null}
"security": [
  {
    "BearerAuth": []
  }
]
```