Get LCA Calculation Errors

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/lca/portfolio/{lca_id}/calculation-errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/lca/portfolio/{lca_id}/calculation-errors"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": {
    "code": "<string>",
    "detail": "<string>",
    "block_id": {},
    "block_name": {},
    "pieces": {
      "piece_id": {},
      "piece_name": {}
    }
  }
}

GET

lca

portfolio

{lca_id}

calculation-errors

Get LCA Calculation Errors

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/lca/portfolio/{lca_id}/calculation-errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/lca/portfolio/{lca_id}/calculation-errors"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": {
    "code": "<string>",
    "detail": "<string>",
    "block_id": {},
    "block_name": {},
    "pieces": {
      "piece_id": {},
      "piece_name": {}
    }
  }
}

Get LCA Calculation Errors

List every data problem that distorts the calculated results of an LCA without failing the calculation. Pieces without a linked activity or emission factor contribute 0 to every category, and pieces with incomplete unit conversions are dropped entirely — this endpoint surfaces those silent omissions, attributed to the canvas block they live in, so they can be fixed.

Request

Path Parameters

uuid

required

The UUID of the LCA portfolioExample: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Query Parameters

uuid

Filter the items to a single canvas block.Example: e5f6a7b8-c9d0-1234-ef01-567890123456

Response

array[object]

One item per (error code, canvas block) combination

Show Calculation Error Item

string

Machine-readable error code:

missing_emission_factor — piece has no emission factor associated
invalid_conversions — piece has incomplete unit conversions
pending_distances — distribution distances are still being calculated
distribution_route_errors — distribution routes failed and cannot be calculated
circular_reference — blocks form a circular connection and cannot be calculated
relation_in_multiple_blocks — a material instance is listed in more than one material block; its impact is attributed to only one of them
missing_transport_destination — transport block has no destination process connected; its transport impact is not calculated
missing_transport_origin — transport block has no material connected as origin; there is nothing to transport
missing_transport_data — material has no transport distance or route resolved; its transport impact is treated as 0
missing_transport_emission_factor — the carrier type has no emission factor; the transport impact is treated as 0

string

Human-readable explanation

string | null

Canvas block the error is attributed to (null when not attributable to a single block)

string | null

Block display name

array[object]

Affected pieces (empty for block-level errors)

Show Piece Object

string | null

Piece UUID

string | null

Piece display name

Example

curl -X GET "https://api.dcycle.io/lca/portfolio/a1b2c3d4-e5f6-7890-abcd-ef1234567890/calculation-errors" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

import requests
import os

headers = {
    "x-api-key": os.getenv("DCYCLE_API_KEY"),
    "x-organization-id": os.getenv("DCYCLE_ORG_ID")
}

lca_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
response = requests.get(
    f"https://api.dcycle.io/lca/portfolio/{lca_id}/calculation-errors",
    headers=headers,
)

for item in response.json()["items"]:
    block = item["block_name"] or "LCA-wide"
    print(f"[{item['code']}] {block}: {item['detail']}")
    for piece in item["pieces"]:
        print(f"  - {piece['piece_name']}")

Successful Response

{
  "items": [
    {
      "code": "missing_emission_factor",
      "detail": "Piece is linked to an activity without emission factors for its region and methodology, so it counts as 0 in every category.",
      "block_id": "e5f6a7b8-c9d0-1234-ef01-567890123456",
      "block_name": "Raw materials",
      "pieces": [
        {
          "piece_id": "b8c9d0e1-f2a3-4567-1234-890123456789",
          "piece_name": "Recycled aluminium"
        }
      ]
    },
    {
      "code": "invalid_conversions",
      "detail": "Piece has incomplete unit conversions, so it is silently dropped from the calculation.",
      "block_id": "e5f6a7b8-c9d0-1234-ef01-567890123456",
      "block_name": "Raw materials",
      "pieces": [
        {
          "piece_id": "c9d0e1f2-a3b4-5678-2345-901234567890",
          "piece_name": "Cardboard box"
        }
      ]
    }
  ]
}

An empty items array means no data problems were detected.

Common Errors

404 Not Found

Cause: LCA does not exist or does not belong to the specified organization

{
  "code": "NOT_FOUND",
  "detail": "LCA not found"
}

Get LCA Dashboard

Calculated impact results by life cycle stage

LCA Overview

LCA API introduction and concepts

​Get LCA Calculation Errors

​Request

​Path Parameters

​Headers

​Query Parameters

​Response

​Example

​Successful Response

​Common Errors

​404 Not Found

​Related Endpoints

Get LCA Dashboard

LCA Overview

Get LCA Calculation Errors

Request

Path Parameters

Headers

Query Parameters

Response

Example

Successful Response

Common Errors

404 Not Found

Related Endpoints