Skip to main content
POST
/
v1
/
lca
/
create-from-json
Create LCA from JSON
const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': '<content-type>'
  },
  body: JSON.stringify({
    name: '<string>',
    unit: '<string>',
    value: 123,
    start_date: '<string>',
    end_date: '<string>',
    start_node: '<string>',
    nodes: {}
  })
};

fetch('https://api.dcycle.io/v1/lca/create-from-json', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "acv_id": "<string>",
  "summary": {}
}

​
Create LCA from JSON

Creates a complete LCA portfolio with all its components (processes, materials, energy, waste, transport) from a hierarchical JSON tree structure. This is the recommended endpoint for programmatic LCA creation.
This endpoint requires API key authentication only (x-api-key header).

​
Request

​
Authentication

​
x-api-key
string
required
Your API keyExample: sk_live_1234567890abcdef

​
Headers

​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
​
Content-Type
string
required
Must be application/json

​
Body Parameters

​
name
string
required
Name of the LCA portfolio
​
unit
string
required
Functional unit name (e.g. "kg", "unit", "m2")
​
value
number
required
Functional unit quantity (must be >= 0)
​
start_date
string
required
Start date of the assessment periodFormat: YYYY-MM-DD
​
end_date
string
required
End date of the assessment period (must be after start_date)Format: YYYY-MM-DD
​
start_node
string
required
ID of the root node in the nodes dictionary. Must be a process type node.
​
nodes
object
required
Dictionary of node definitions keyed by node ID. Each node has a type that determines its fields.Node types:

​
Response

Returns HTTP 201 with the created LCA information.
​
acv_id
string
UUID of the created LCA portfolio
​
summary
object
Summary of the created LCA structure

​
Example

curl -X POST "https://api.dcycle.io/v1/lca/create-from-json" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Wooden Table LCA",
    "unit": "unit",
    "value": 1.0,
    "start_date": "2024-01-01",
    "end_date": "2024-12-31",
    "start_node": "assembly",
    "nodes": {
      "assembly": {
        "type": "process",
        "name": "Table Assembly",
        "location": "ES",
        "children": ["wood", "steel_bolts", "electricity", "transport_wood"],
        "attributes": {}
      },
      "wood": {
        "type": "material",
        "name": "Sawn timber, softwood",
        "supplier": "Forest Co",
        "location": "FI",
        "quantity": 15.0,
        "unit": "kg"
      },
      "steel_bolts": {
        "type": "material",
        "name": "Steel, low-alloyed",
        "supplier": "Steel Inc",
        "location": "DE",
        "quantity": 0.5,
        "unit": "kg"
      },
      "electricity": {
        "type": "energy",
        "name": "Electricity",
        "location": "ES",
        "quantity": 2.5,
        "unit": "kWh"
      },
      "transport_wood": {
        "type": "transport",
        "name": "Wood transport from Finland",
        "transport_type": "truck",
        "quantity": 45.0,
        "unit": "tkm",
        "children": ["wood"]
      }
    }
  }'

​
Successful Response

{
  "acv_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "summary": {
    "name": "Wooden Table LCA",
    "nodes_created": 5,
    "processes": 1,
    "materials": 2,
    "energy": 1,
    "transport": 1
  }
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

​
422 Unprocessable Entity

Cause: Invalid tree structure, missing nodes, or broken references 
{
  "detail": [
    {
      "loc": ["body", "start_node"],
      "msg": "start_node 'missing_node' not found in nodes",
      "type": "value_error"
    }
  ]
}

​
422 Unprocessable Entity — Invalid date range

Cause: Invalid or missing required fields in the request body 
{
  "detail": [
    {
      "loc": ["body", "end_date"],
      "msg": "End date must be after start date",
      "type": "value_error"
    }
  ]
}

Create LCA Portfolio

Create a basic portfolio (without tree structure)

List LCA Portfolios

Browse all LCA portfolios

LCA Dashboard

View environmental impact results