Introduction

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.

Real-Time LCA OpenAPI specification

View the OpenAPI specification file

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. You can obtain a token either with a user’s email and password, or with an account’s client ID and secret for server-to-server (machine-to-machine) integrations.

User credentials

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

{
  "email": "you@example.com",
  "password": "your-password"
}

A successful (200 OK) response returns a bearer token.

Account token

For integrations that authenticate as an account rather than a user, send a POST request to the authentication host with an account client ID and secret:

POST https://auth.realtimelca.com/frontegg/identity/resources/auth/v2/api-token

{
  "clientId": "",
  "secret": ""
}

A successful (200 OK) response returns an access token, a refresh token, and the token’s expiry:

{
  "access_token": "",
  "refresh_token": "",
  "expires_in": 86400,
  "expires": ""
}

To get a client ID and secret for your account, contact support@realtimelca.com.

Using the token

Include the token on subsequent requests via the Authorization header:

Authorization: Bearer <token>

Protected endpoints declare the requirement in the spec as:

"security": [
  {
    "BearerAuth": []
  }
]

API documentation

Agent ready

Welcome

Real-Time LCA OpenAPI specification

Base URLs

Authentication

User credentials

Account token

Using the token

​Welcome

Real-Time LCA OpenAPI specification

​Base URLs

​Authentication

​User credentials

​Account token

​Using the token

Welcome

Base URLs

Authentication

User credentials

Account token

Using the token