Skip to content

Generated API Reference

This page is generated at build time from www/generated/openapi.json, which is produced by volca dump-openapi.

Use this page for exhaustive endpoint parameters, request bodies, response schemas, and component schemas. For how to use the API, authentication, and common patterns, start with the HTTP API guide.

  • OpenAPI version: 3.0.0
  • Operations: 86
  • Schemas: 133
  • Live server Swagger UI: /api/v1/docs
  • Live server OpenAPI JSON: /api/v1/openapi.json
MethodPathOperation IDSummary
GET/api/v1/db/{dbName}/activity/{processId}get_activityLCA / ACV - get detailed information about an activity: name, location, exchanges, reference product, metadata.
PUT/api/v1/db/{dbName}/activity/{processId} - -
GET/api/v1/db/{dbName}/activity/{processId}/flows - -
GET/api/v1/db/{dbName}/activity/{processId}/inputs - -
GET/api/v1/db/{dbName}/activity/{processId}/outputs - -
GET/api/v1/db/{dbName}/activity/{processId}/reference-product - -
GET/api/v1/db/{dbName}/activity/{processId}/tree - -
GET/api/v1/db/{dbName}/activity/{processId}/inventoryget_inventoryLCA / ACV - compute the Life Cycle Inventory (LCI): biosphere flows (emissions and resource extractions) for an activity's full supply chain.
POST/api/v1/db/{dbName}/activity/{processId}/inventory - -
GET/api/v1/db/{dbName}/activity/{processId}/graph - -
GET/api/v1/db/{dbName}/activity/{processId}/supply-chainget_supply_chainLCA / ACV - get a flat list of all upstream activities in the supply chain (chaîne amont, filière, intrants).
POST/api/v1/db/{dbName}/activity/{processId}/supply-chain - -
GET/api/v1/db/{dbName}/activity/{processId}/aggregateaggregateLCA / ACV - aggregate exchanges, supply chain entries, or biosphere flows with SQL group-by-style filters.
GET/api/v1/db/{dbName}/activity/{processId}/impacts/{collection}score_activityLCA / ACV - compute the full LCIA panel + every configured scoring set for an activity in one call.
POST/api/v1/db/{dbName}/activity/{processId}/impacts/{collection} - -
GET/api/v1/db/{dbName}/activity/{processId}/impacts/{collection}/{methodId}get_impactsLCA / ACV - compute Life Cycle Impact Assessment (LCIA) scores for an activity.
POST/api/v1/db/{dbName}/activity/{processId}/impacts/{collection}/{methodId} - -
POST/api/v1/db/{dbName}/activity/{processId}/sensitivity/{collection}/{methodId}compute_sensitivityLCA / ACV - sensitivity analysis: sweep relative perturbations of technosphere coefficients A_ij and report the resulting impact for each.
GET/api/v1/db/{dbName}/activity/{processId}/consumersget_consumersLCA / ACV - find all activities that transitively consume (depend on) a given supplier.
GET/api/v1/db/{dbName}/activity/{processId}/path-toget_path_toLCA / ACV - find the shortest supply chain path from a process to the first upstream activity whose name matches a pattern.
GET/api/v1/db/{dbName}/activity/{processId}/contributing-flows/{collection}/{methodId}get_contributing_flowsLCA / ACV - identify which elementary flows (emissions/resources) contribute most to a specific impact category.
GET/api/v1/db/{dbName}/activity/{processId}/contributing-activities/{collection}/{methodId}get_contributing_activitiesLCA / ACV - identify which upstream activities contribute most to a specific impact category.
GET/api/v1/db/{dbName}/flow/{flowId} - -
GET/api/v1/db/{dbName}/flow/{flowId}/activities - -
GET/api/v1/methodslist_methodsLCA / ACV - list all loaded LCIA methods (impact assessment methods like climate change, acidification, eutrophication, land use, water scarcity)..
GET/api/v1/method/{methodId} - -
GET/api/v1/method/{methodId}/factors - -
GET/api/v1/db/{dbName}/method/{methodId}/mapping - -
GET/api/v1/db/{dbName}/method/{methodId}/flow-mappingget_flow_mappingLCA / ACV - get the mapping between a method's characterization factors and database flows, showing match coverage..
GET/api/v1/db/{dbName}/method-collection/{collection}/coverage - -
GET/api/v1/db/{dbName}/method/{methodId}/characterizationget_characterizationLCA / ACV - look up characterization factors for a method matched against database flows.
GET/api/v1/db/{dbName}/method/{methodId}/explain-cf/{flowId}explain_cfLCA / ACV - explain why one elementary flow scores with the characterization factor it does.
GET/api/v1/db/{dbName}/flowssearch_flowsLCA / ACV - search for biosphere flows (emissions, resources) by name.
GET/api/v1/db/{dbName}/activitiessearch_activitiesLCA / ACV - search for activities (processes) by name, geography, product, classification, or preset.
POST/api/v1/db/{dbName}/activities - -
GET/api/v1/db/{dbName}/classificationslist_classificationsLCA / ACV - list classification systems in a database.
POST/api/v1/db/{dbName}/impacts/{collection}score_activitiesLCA / ACV - rank N activities against one scoring set in one call.
GET/api/v1/dblist_databasesLCA / ACV - list all loaded LCA databases (Agribalyse, ecoinvent, …).
POST/api/v1/db/{dbName}/loadload_databaseLCA / ACV - load a configured database into memory so it can be queried.
POST/api/v1/db/{dbName}/unloadunload_databaseLCA / ACV - unload a database from memory to free RAM.
POST/api/v1/db/{dbName}/relink - -
GET/api/v1/db/{dbName}/gap-reportget_gap_reportLCA / ACV - supplier-gap report of a database: every input demand still unsupplied after internal resolution and cross-database linking, aggregated per (product, location, unit) and ranked by demanding edges.
GET/api/v1/db/{dbName}/quality-reportget_quality_reportLCA / ACV - dataset-soundness report of a database, for the people who build or repair one: the structural defects a score cannot reveal.
GET/api/v1/db/{dbName}/computed-quality-reportget_computed_quality_reportLCA / ACV - computed-checks report of a LOADED database: what the data computes, judged against the catalogue's own norms.
GET/api/v1/db/{dbName}/characterization-coverageget_characterization_coverageLCA / ACV - characterization-coverage report of a database against the loaded LCIA method collections, for the people who maintain databases.
POST/api/v1/db/{dbName}/copy/{newName} - -
DELETE/api/v1/db/{dbName} - -
POST/api/v1/db/{dbName}/delete - -
POST/api/v1/db/{dbName}/activity/{processId}/exchangesedit_exchangesLCA / ACV - change what one activity consumes and emits, keeping the activity itself.
POST/api/v1/db/{dbName}/export - -
POST/api/v1/db/upload - -
GET/api/v1/db/{dbName}/setup - -
POST/api/v1/db/{dbName}/add-dependency/{depName} - -
POST/api/v1/db/{dbName}/remove-dependency/{depName} - -
POST/api/v1/db/{dbName}/set-data-path - -
POST/api/v1/db/{dbName}/finalize - -
GET/api/v1/method-collections - -
POST/api/v1/method-collections/{name}/load - -
POST/api/v1/method-collections/{name}/unload - -
DELETE/api/v1/method-collections/{name} - -
POST/api/v1/method-collections/upload - -
POST/api/v1/method-collections/{name}/export - -
GET/api/v1/flow-synonyms - -
POST/api/v1/flow-synonyms/{name}/load - -
POST/api/v1/flow-synonyms/{name}/unload - -
DELETE/api/v1/flow-synonyms/{name} - -
POST/api/v1/flow-synonyms/upload - -
GET/api/v1/flow-synonyms/{name}/groups - -
GET/api/v1/flow-synonyms/{name}/download - -
GET/api/v1/compartment-mappings - -
POST/api/v1/compartment-mappings/{name}/load - -
POST/api/v1/compartment-mappings/{name}/unload - -
DELETE/api/v1/compartment-mappings/{name} - -
POST/api/v1/compartment-mappings/upload - -
GET/api/v1/units - -
POST/api/v1/units/{name}/load - -
POST/api/v1/units/{name}/unload - -
DELETE/api/v1/units/{name} - -
POST/api/v1/units/upload - -
GET/api/v1/logs - -
POST/api/v1/auth - -
GET/api/v1/version - -
GET/api/v1/hosting - -
GET/api/v1/stats - -
GET/api/v1/classification-presetslist_presetsLCA / ACV - list named classification filter presets configured in this instance.
GET/api/v1/openapi.json - -

GET /api/v1/db/{dbName}/activity/{processId}

Operation ID: get_activity

Summary: LCA / ACV - get detailed information about an activity: name, location, exchanges, reference product, metadata.

LCA / ACV - get detailed information about an activity: name, location, exchanges, reference product, metadata. Use exchange_type / is_input / flow to filter exchanges and reduce response size.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivityInfo -
404`dbName` or `processId` not found`dbName` or `processId` not found

PUT /api/v1/db/{dbName}/activity/{processId}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8ActivityInput

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivityWriteResponse -
400Invalid `body`Invalid `body`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/flows

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: FlowSummary[] -
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/inputs

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ExchangeDetail[] -
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/outputs

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ExchangeDetail[] -
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/reference-product

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: FlowDetail -
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/tree

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: TreeExport -
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/inventory

Operation ID: get_inventory

Summary: LCA / ACV - compute the Life Cycle Inventory (LCI): biosphere flows (emissions and resource extractions) for an activity's full supply chain.

LCA / ACV - compute the Life Cycle Inventory (LCI): biosphere flows (emissions and resource extractions) for an activity's full supply chain. Returns statistics and top flows by quantity. Use this (not get_impacts) when the question targets raw physical flows rather than weighted scores: land / pasture occupation (m²·year), water withdrawal (m³), specific emissions (kg CO₂, kg CH₄, kg N), resource extraction.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: InventoryExport -
404`dbName` or `processId` not found`dbName` or `processId` not found

POST /api/v1/db/{dbName}/activity/{processId}/inventory

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8SubstitutionRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: InventoryExport -
400Invalid `body`Invalid `body`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/graph

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
cutoffquerynonumber -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: GraphExport -
400Invalid `cutoff`Invalid `cutoff`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/supply-chain

Operation ID: get_supply_chain

Summary: LCA / ACV - get a flat list of all upstream activities in the supply chain (chaîne amont, filière, intrants).

LCA / ACV - get a flat list of all upstream activities in the supply chain (chaîne amont, filière, intrants). The 'quantity' field is the cumulative scaled amount relative to the functional unit (scaling_factor × root reference product amount). To get the per-step yield ratio between two connected entries, divide the supplier's scaling_factor by the consumer's scaling_factor. Summing quantities across entries that feed each other (electricity high→medium→low voltage) double-counts the chain - use aggregate with scope=consumption for upstream totals.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
namequerynostringFilter by activity name
limitquerynointegerMax results (default 100)
min-quantityquerynonumber -
offsetquerynointeger -
max-depthquerynointeger -
locationquerynostringFilter by location
productquerynostring -
presetquerynostringName of a classification preset (from list_presets) - expands to its bundled filters. Unioned with any explicit classification / classification_value / classification_mode parameters.
classificationquerynostring[]Classification system name (e.g. 'Category', 'Category type')
classification-valuequerynostring[] -
classification-modequerynostring[] -
sortquerynostring -
orderquerynostring -
include-edgesquerynoboolean -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SupplyChainResponse -
400Invalid `include-edges` or `order` or `sort` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `max-depth` or `offset` or `min-quantity` or `limit` or `name`Invalid `include-edges` or `order` or `sort` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `max-depth` or `offset` or `min-quantity` or `limit` or `name`
404`dbName` or `processId` not found`dbName` or `processId` not found

POST /api/v1/db/{dbName}/activity/{processId}/supply-chain

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
namequerynostring -
limitquerynointeger -
min-quantityquerynonumber -
offsetquerynointeger -
max-depthquerynointeger -
locationquerynostring -
productquerynostring -
presetquerynostring -
classificationquerynostring[] -
classification-valuequerynostring[] -
classification-modequerynostring[] -
sortquerynostring -
orderquerynostring -
include-edgesquerynoboolean -

Request body

Media typeSchema
application/json;charset=utf-8SubstitutionRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SupplyChainResponse -
400Invalid `body` or `include-edges` or `order` or `sort` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `max-depth` or `offset` or `min-quantity` or `limit` or `name`Invalid `body` or `include-edges` or `order` or `sort` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `max-depth` or `offset` or `min-quantity` or `limit` or `name`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/aggregate

Operation ID: aggregate

Summary: LCA / ACV - aggregate exchanges, supply chain entries, or biosphere flows with SQL group-by-style filters.

LCA / ACV - aggregate exchanges, supply chain entries, or biosphere flows with SQL group-by-style filters. One primitive replaces ad-hoc decomposition tools - express any 'how much X is in Y' question as one call. Also the right tool for 'combien de surface agricole / d'eau / d'énergie dans un produit ?' style questions via scope=biosphere or scope=supply_chain. Examples: - Total electricity in direct inputs: scope=direct, is_input=true, filter_name=Electricity, filter_unit=kWh - Mass breakdown of direct inputs: scope=direct, is_input=true, filter_unit=kg, group_by=name - Total energy across the supply chain: scope=supply_chain, max_depth=2, filter_classification=["Category type=energy:exact"] - Largest pasture occupation flow: scope=biosphere, filter_name=Occupation, pasture, group_by=name - Total upstream electricity without double counting: scope=consumption, filter_name=electricity, filter_consumer_not=electricity - Grass eaten by cattle across the whole chain: scope=consumption, filter_name=grass, filter_consumer=cattle scope=supply_chain rows are cumulative productions: when a filtered product feeds another filtered product (electricity high→medium→low voltage), their sum double-counts the chain. scope=consumption has one row per scaled technosphere edge (product, supplier, consumer), so its sums are actual consumption events; the default total is gross throughput - exclude intra-family edges with filter_consumer_not to get the amount delivered outside the filtered family. Byproduct edges keep their negative sign. The filter_classification parameter accepts a list of strings in "System=Value[:exact]" form (default mode is 'contains').

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
scopequerynostringdirect | supply_chain | biosphere | consumption
is_inputquerynobooleanOnly for scope=direct - true=inputs only, false=outputs only
max_depthquerynointegerOnly for scope=supply_chain - max hops from the root activity
filter_namequerynostringCase-insensitive substring on flow/activity name
filter_name_notquerynostringComma-separated substring exclude list
filter_unitquerynostringExact unit name
presetquerynostringName of a classification preset (from list_presets) - expanded and merged into filter_classification.
filter_classificationquerynostring[]List of "System=Value[:exact]" strings; defaults to 'contains' mode
filter_target_namequerynostringOnly for scope=direct technosphere or scope=consumption - filter by supplier activity name
filter_consumerquerynostringOnly for scope=consumption - case-insensitive substring on the consuming activity's name
filter_consumer_notquerynostringOnly for scope=consumption - comma-separated consumer-name exclude list (each item is a substring; a name containing a comma cannot be expressed)
filter_exchange_typequerynostring -
filter_is_referencequerynobooleanFilter by reference-product flag (typically for outputs)
group_byquerynostringname | flow_id | name_prefix | unit | classification.<system> | location | target_name | consumer_name
aggregatequerynostringsum_quantity | count | share (default: sum_quantity)

Responses

StatusSchemaDescription
200application/json;charset=utf-8: Aggregation -
400Invalid `aggregate` or `group_by` or `filter_is_reference` or `filter_exchange_type` or `filter_consumer_not` or `filter_consumer` or `filter_target_name` or `filter_classification` or `preset` or `filter_unit` or `filter_name_not` or `filter_name` or `max_depth` or `is_input` or `scope`Invalid `aggregate` or `group_by` or `filter_is_reference` or `filter_exchange_type` or `filter_consumer_not` or `filter_consumer` or `filter_target_name` or `filter_classification` or `preset` or `filter_unit` or `filter_name_not` or `filter_name` or `max_depth` or `is_input` or `scope`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/impacts/{collection}

Operation ID: score_activity

Summary: LCA / ACV - compute the full LCIA panel + every configured scoring set for an activity in one call.

LCA / ACV - compute the full LCIA panel + every configured scoring set for an activity in one call. Returns per-method impact scores, per-scoring-set aggregate scores, per-scoring-set indicator breakdown (one entry per scoring variable), display units, and a 'web_url' to the matching view. Use this when you would otherwise call get_impacts N times across every method of a collection - replaces N round-trips with one batched solve. Discover available scoring sets with list_scoring_sets. Render the 'web_url' as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstringMethod collection name (use list_methods to discover)
exclude-long-termquerynoboolean -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: LCIABatchResult -
400Invalid `exclude-long-term`Invalid `exclude-long-term`
404`dbName` or `processId` or `collection` not found`dbName` or `processId` or `collection` not found

POST /api/v1/db/{dbName}/activity/{processId}/impacts/{collection}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstring -
exclude-long-termquerynoboolean -

Request body

Media typeSchema
application/json;charset=utf-8SubstitutionRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: LCIABatchResult -
400Invalid `body` or `exclude-long-term`Invalid `body` or `exclude-long-term`
404`dbName` or `processId` or `collection` not found`dbName` or `processId` or `collection` not found

GET /api/v1/db/{dbName}/activity/{processId}/impacts/{collection}/{methodId}

Operation ID: get_impacts

Summary: LCA / ACV - compute Life Cycle Impact Assessment (LCIA) scores for an activity.

LCA / ACV - compute Life Cycle Impact Assessment (LCIA) scores for an activity. Returns the score, functional unit, and top contributing elementary flows. Answers 'empreinte carbone / environmental footprint' questions. Covers all LCIA categories: climate change, acidification, eutrophication, land use, water scarcity, resource depletion. Prefer this over web estimates for grounded, database-backed answers. Each contributing flow carries 'match_kind' - how its factor was found, in the rung names documented on explain_cf; null means the method's tables never walked this flow (it arrived from a dependency database), not that it is uncharacterized. Ask explain_cf for the full story on one flow. The response includes a 'web_url' deep link to the impacts page in the VoLCA web UI - render it as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstringMethod collection name (from list_methods). Only needed when the same method UUID is loaded in more than one collection (e.g. two EF 3.1 versions); otherwise the single match is used, and an ambiguous UUID fails with the list of collections to choose from.
methodIdpathyesstring -
top-flowsquerynointeger -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: LCIAResult -
400Invalid `top-flows`Invalid `top-flows`
404`dbName` or `processId` or `collection` or `methodId` not found`dbName` or `processId` or `collection` or `methodId` not found

POST /api/v1/db/{dbName}/activity/{processId}/impacts/{collection}/{methodId}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstring -
methodIdpathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8SubstitutionRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: LCIAResult -
400Invalid `body`Invalid `body`
404`dbName` or `processId` or `collection` or `methodId` not found`dbName` or `processId` or `collection` or `methodId` not found

POST /api/v1/db/{dbName}/activity/{processId}/sensitivity/{collection}/{methodId}

Operation ID: compute_sensitivity

Summary: LCA / ACV - sensitivity analysis: sweep relative perturbations of technosphere coefficients A_ij and report the resulting impact for each.

LCA / ACV - sensitivity analysis: sweep relative perturbations of technosphere coefficients A_ij and report the resulting impact for each. Each perturbation specifies (consumer, supplier, delta) where 'delta' is relative: A_ij is multiplied by (1+delta). delta=+0.05 → +5%; delta=-1 removes the link. Returns the baseline impact plus one entry per perturbation with the new score and deltaImpact. Per-perturbation errors (no link, singular update) are returned in the entry; the sweep continues. Internally uses Sherman-Morrison rank-1 updates against the cached factorization (~4 ms per perturbation). V1: root DB only. The response includes a 'web_url' deep link to the sensitivity page in the VoLCA web UI - render it as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstringMethod collection name (from list_methods). Only needed when the same method UUID is loaded in more than one collection (e.g. two EF 3.1 versions); otherwise the single match is used, and an ambiguous UUID fails with the list of collections to choose from.
methodIdpathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8SensitivityRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SensitivityResponse -
400Invalid `body`Invalid `body`
404`dbName` or `processId` or `collection` or `methodId` not found`dbName` or `processId` or `collection` or `methodId` not found

GET /api/v1/db/{dbName}/activity/{processId}/consumers

Operation ID: get_consumers

Summary: LCA / ACV - find all activities that transitively consume (depend on) a given supplier.

LCA / ACV - find all activities that transitively consume (depend on) a given supplier. Returns a flat list, each with a crDepth field: 1 = direct consumer, 2 = consumer of consumer, etc. Useful for tracing downstream use of a raw material - e.g. finding transformed food products in Agribalyse that use a raw ingredient.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
namequerynostringFilter by name (case-insensitive substring)
locationquerynostringFilter by geography/location (case-insensitive substring, e.g. 'FR', 'DE')
productquerynostringFilter by product name (case-insensitive substring)
presetquerynostringName of a classification preset (from list_presets) - expands to its bundled filters
classificationquerynostring[]Classification system name (e.g. 'ISIC rev.4 ecoinvent')
classification-valuequerynostring[] -
classification-modequerynostring[] -
limitquerynointegerMax results (default 1000)
offsetquerynointeger -
max-depthquerynointeger -
sortquerynostring -
orderquerynostring -
include-edgesquerynoboolean -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ConsumersResponse -
400Invalid `include-edges` or `order` or `sort` or `max-depth` or `offset` or `limit` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `name`Invalid `include-edges` or `order` or `sort` or `max-depth` or `offset` or `limit` or `classification-mode` or `classification-value` or `classification` or `preset` or `product` or `location` or `name`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/path-to

Operation ID: get_path_to

Summary: LCA / ACV - find the shortest supply chain path from a process to the first upstream activity whose name matches a pattern.

LCA / ACV - find the shortest supply chain path from a process to the first upstream activity whose name matches a pattern. Each step includes cumulative_quantity, scaling_factor, and local_step_ratio (upstream ÷ downstream scaling factors). total_ratio is the product of all local_step_ratio values - the end-to-end conversion factor.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
targetquerynostringCase-insensitive name substring to stop at

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -
400Invalid `target`Invalid `target`
404`dbName` or `processId` not found`dbName` or `processId` not found

GET /api/v1/db/{dbName}/activity/{processId}/contributing-flows/{collection}/{methodId}

Operation ID: get_contributing_flows

Summary: LCA / ACV - identify which elementary flows (emissions/resources) contribute most to a specific impact category.

LCA / ACV - identify which elementary flows (emissions/resources) contribute most to a specific impact category. Answers 'which emissions drive my climate change score?'. Each flow carries 'match_kind' - how its factor was found, in the rung names documented on explain_cf; null means the method's tables never walked this flow (it arrived from a dependency database), not that it is uncharacterized. Ask explain_cf for the full story on one flow. The response includes a 'web_url' deep link to the contributing-flows page in the VoLCA web UI - render it as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstringMethod collection name (from list_methods). Only needed when the same method UUID is loaded in more than one collection (e.g. two EF 3.1 versions); otherwise the single match is used, and an ambiguous UUID fails with the list of collections to choose from.
methodIdpathyesstring -
limitquerynointegerMax flows to return, sorted by contribution (default 20)
exclude-long-termquerynoboolean -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ContributingFlowsResult -
400Invalid `exclude-long-term` or `limit`Invalid `exclude-long-term` or `limit`
404`dbName` or `processId` or `collection` or `methodId` not found`dbName` or `processId` or `collection` or `methodId` not found

GET /api/v1/db/{dbName}/activity/{processId}/contributing-activities/{collection}/{methodId}

Operation ID: get_contributing_activities

Summary: LCA / ACV - identify which upstream activities contribute most to a specific impact category.

LCA / ACV - identify which upstream activities contribute most to a specific impact category. Answers 'which suppliers drive my climate change score?' Uses exact matrix-based computation, valid even for cyclic supply chains. Each contributing activity carries a 'web_url' deep link to its page in the VoLCA web UI - render these as clickable markdown links when presenting results to a human so they can drill into a specific supplier.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -
collectionpathyesstringMethod collection name (from list_methods). Only needed when the same method UUID is loaded in more than one collection (e.g. two EF 3.1 versions); otherwise the single match is used, and an ambiguous UUID fails with the list of collections to choose from.
methodIdpathyesstring -
limitquerynointegerMax processes to return, sorted by contribution (default 10)
exclude-long-termquerynoboolean -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ContributingActivitiesResult -
400Invalid `exclude-long-term` or `limit`Invalid `exclude-long-term` or `limit`
404`dbName` or `processId` or `collection` or `methodId` not found`dbName` or `processId` or `collection` or `methodId` not found

GET /api/v1/db/{dbName}/flow/{flowId}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
flowIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: FlowDetail -
404`dbName` or `flowId` not found`dbName` or `flowId` not found

GET /api/v1/db/{dbName}/flow/{flowId}/activities

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
flowIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivitySummary[] -
404`dbName` or `flowId` not found`dbName` or `flowId` not found

GET /api/v1/methods

Operation ID: list_methods

Summary: LCA / ACV - list all loaded LCIA methods (impact assessment methods like climate change, acidification, eutrophication, land use, water scarcity)..

LCA / ACV - list all loaded LCIA methods (impact assessment methods like climate change, acidification, eutrophication, land use, water scarcity).

Responses

StatusSchemaDescription
200application/json;charset=utf-8: MethodSummary[] -

GET /api/v1/method/{methodId}

Parameters

NameInRequiredTypeDescription
methodIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: MethodDetail -
404`methodId` not found`methodId` not found

GET /api/v1/method/{methodId}/factors

Parameters

NameInRequiredTypeDescription
methodIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: MethodFactorAPI[] -
404`methodId` not found`methodId` not found

GET /api/v1/db/{dbName}/method/{methodId}/mapping

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
methodIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: MappingStatus -
404`dbName` or `methodId` not found`dbName` or `methodId` not found

GET /api/v1/db/{dbName}/method/{methodId}/flow-mapping

Operation ID: get_flow_mapping

Summary: LCA / ACV - get the mapping between a method's characterization factors and database flows, showing match coverage..

LCA / ACV - get the mapping between a method's characterization factors and database flows, showing match coverage.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
methodIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: FlowCFMapping -
404`dbName` or `methodId` not found`dbName` or `methodId` not found

GET /api/v1/db/{dbName}/method-collection/{collection}/coverage

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
collectionpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: CollectionCoverage -
404`dbName` or `collection` not found`dbName` or `collection` not found

GET /api/v1/db/{dbName}/method/{methodId}/characterization

Operation ID: get_characterization

Summary: LCA / ACV - look up characterization factors for a method matched against database flows.

LCA / ACV - look up characterization factors for a method matched against database flows. Without 'flow' filter, returns top factors by absolute value. With 'flow', searches by name. Shows CF value, direction, matched database flow, and match strategy.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
methodIdpathyesstring -
flowquerynostringFilter by flow name (case-insensitive substring, matches both method CF name and database flow name)
limitquerynointegerMax results (default 20)

Responses

StatusSchemaDescription
200application/json;charset=utf-8: CharacterizationResult -
400Invalid `limit` or `flow`Invalid `limit` or `flow`
404`dbName` or `methodId` not found`dbName` or `methodId` not found

GET /api/v1/db/{dbName}/method/{methodId}/explain-cf/{flowId}

Operation ID: explain_cf

Summary: LCA / ACV - explain why one elementary flow scores with the characterization factor it does.

LCA / ACV - explain why one elementary flow scores with the characterization factor it does. Answers 'why this factor, and which line of the method was used?'. The 'explanation' field is a list of sentences written by the engine: relay them as they are rather than interpreting the codes yourself. 'outcome' is one of: 'characterized' (a factor applies), 'conversion_refused' (a factor was found but the flow's unit cannot be converted to the factor's basis, so the flow scores nothing), 'no_factor' (nothing in the method reaches this flow). 'match.rung' names how the factor was found: 'flow_id' (the method names this exact flow), 'same_unit_name' (a factor line declared in this flow's own unit), 'exact_name' (name and compartment match), 'long_term_default' (the method's default for long-term emissions), 'compartment_default' (the method's default for the whole compartment), 'cas_number' (a factor for the same substance by CAS), 'subcompartment_blind' (the factor is the same in every subcompartment), 'region_base_name' (the base substance, the name's region suffix being untagged by the method), 'energy_content' (the family factor per unit of energy, bridged by the flow's calorific value), 'ore_base_element' (the base element of a graded ore). 'steps_tried' lists the rungs tried before that one, including any refused by a subcompartment veto. 'match.unitConversion' names the bridge that carried the amount onto the factor's basis: 'same_unit', 'unknown_unit' (the flow's unit is not in the unit table, so the amount passed as declared), 'unit_converted', 'normalized_to_base_unit' (the factor is written as a result expression like 'kg CO2 eq', so the amount was brought to the flow's base unit), 'energy_content' (carried across dimensions by the flow's energy density). 'match.refusal' names why no bridge could: 'different_dimensions', 'no_base_unit', 'energy_bridge_failed'. A vetoed step names its rule in 'veto': 'different_receiving_medium' (the method writes sea-water lines and so meant to leave this foreign medium out), 'long_term_groundwater' (a long-term groundwater emission must not borrow a surface-fate factor). The response includes a 'web_url' deep link to the explain-cf page in the VoLCA web UI - render it as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
methodIdpathyesstring -
flowIdpathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ExplainCFResult -
404`dbName` or `methodId` or `flowId` not found`dbName` or `methodId` or `flowId` not found

GET /api/v1/db/{dbName}/flows

Operation ID: search_flows

Summary: LCA / ACV - search for biosphere flows (emissions, resources) by name.

LCA / ACV - search for biosphere flows (emissions, resources) by name. Use this to locate specific substances (CO2, CH4, water, land occupation) before querying characterization factors or inventory contributions.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
qquerynostring -
langquerynostring -
limitquerynointegerMax results (default 20)
offsetquerynointeger -
sortquerynostring -
orderquerynostring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SearchResults_FlowSearchResult -
400Invalid `order` or `sort` or `offset` or `limit` or `lang` or `q`Invalid `order` or `sort` or `offset` or `limit` or `lang` or `q`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/activities

Operation ID: search_activities

Summary: LCA / ACV - search for activities (processes) by name, geography, product, classification, or preset.

LCA / ACV - search for activities (processes) by name, geography, product, classification, or preset. Returns a paginated list of matching activities with their process IDs. Entry point for any LCA/ACV question about a specific product or process - food (yaourt, steak, pain, lait, fromage), packaging (PET, verre, carton), matériaux, énergie, transport. Accepts non-technical synonyms: empreinte carbone, empreinte environnementale, impact environnemental, occupation des sols, surface agricole, prairie, pâturage, intrants, filière, chaîne amont.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
namequerynostringName substring to search for (or exact name if exact=true)
geoquerynostringGeography/location filter (e.g. 'FR', 'DE', 'GLO')
productquerynostringProduct name filter
exactquerynobooleanIf true, name and geo must match exactly (case-insensitive equality) instead of substring search
presetquerynostringName of a classification preset (from list_presets) - expands to its bundled filters. Can be combined with explicit classification filters.
classificationquerynostring[]Classification system name to filter by (e.g. 'ISIC rev.4 ecoinvent', 'CPC'). Use list_classifications to see available systems.
classification-valuequerynostring[] -
classification-modequerynostring[] -
limitquerynointegerMax results (default 20)
offsetquerynointeger -
sortquerynostring -
orderquerynostring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SearchResults_ActivitySummary -
400Invalid `order` or `sort` or `offset` or `limit` or `classification-mode` or `classification-value` or `classification` or `preset` or `exact` or `product` or `geo` or `name`Invalid `order` or `sort` or `offset` or `limit` or `classification-mode` or `classification-value` or `classification` or `preset` or `exact` or `product` or `geo` or `name`
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/activities

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8ActivityWriteRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivityWriteResponse -
400Invalid `body`Invalid `body`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/classifications

Operation ID: list_classifications

Summary: LCA / ACV - list classification systems in a database.

LCA / ACV - list classification systems in a database. Without 'system': returns system names and activity counts only (lightweight). With 'system': returns all values for that system. Add 'filter' to narrow values by substring.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ClassificationSystem[] -
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/impacts/{collection}

Operation ID: score_activities

Summary: LCA / ACV - rank N activities against one scoring set in one call.

LCA / ACV - rank N activities against one scoring set in one call. Returns a columnar JSON shape: {scoring_set, scoring_unit, functional_unit?, columns, rows, not_found, invalid}. 'columns' is the header (['name', 'process_id', 'web_url', 'total', <indicator keys...>]) and 'rows' is a 2D array of scalars - one row per resolved activity. Hoisting the constant metadata once and packing each activity as a flat array of scalars makes this shape ~6× smaller than a row-shaped JSON for batches of 24+ activities. The top-level 'functional_unit' is only emitted when every resolved row shares the same one; otherwise it is dropped and 'functional_unit' appears as a per-row column instead (the 'columns' header reflects which shape was emitted). Per-method scores are NOT included - call score_activity on a specific process_id for that drill-down. Unresolved process IDs land in not_found / invalid. The chosen scoring set must be unambiguous: pass scoring_sets: ["<one>"] when the collection has more than one scoring set configured. The 'web_url' column on each row is a deep link to the activity's impacts page in the VoLCA web UI - render it as a clickable markdown link when presenting results to a human.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
collectionpathyesstringMethod collection name
top-flowsquerynointeger -
exclude-long-termquerynoboolean -

Request body

Media typeSchema
application/json;charset=utf-8BatchImpactsRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: BatchImpactsResponse -
400Invalid `body` or `exclude-long-term` or `top-flows`Invalid `body` or `exclude-long-term` or `top-flows`
404`dbName` or `collection` not found`dbName` or `collection` not found

GET /api/v1/db

Operation ID: list_databases

Summary: LCA / ACV - list all loaded LCA databases (Agribalyse, ecoinvent, …).

LCA / ACV - list all loaded LCA databases (Agribalyse, ecoinvent, …). Call this first to discover which databases are available before searching.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DatabaseListResponse -

POST /api/v1/db/{dbName}/load

Operation ID: load_database

Summary: LCA / ACV - load a configured database into memory so it can be queried.

LCA / ACV - load a configured database into memory so it can be queried. Its declared dependencies are loaded first (needed for cross-database flow linking). A database must be loaded before search/score/impact tools can target it; use list_databases to see which are configured. No effect if it is already loaded.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: LoadDatabaseResponse -
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/unload

Operation ID: unload_database

Summary: LCA / ACV - unload a database from memory to free RAM.

LCA / ACV - unload a database from memory to free RAM. The on-disk data is kept and the database can be reloaded later with load_database. Refuses if another loaded database still depends on it - unload the dependents first.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/relink

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8RelinkRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: RelinkResponse -
400Invalid `body`Invalid `body`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/gap-report

Operation ID: get_gap_report

Summary: LCA / ACV - supplier-gap report of a database: every input demand still unsupplied after internal resolution and cross-database linking, aggregated per (product, location, unit) and ranked by demanding edges.

LCA / ACV - supplier-gap report of a database: every input demand still unsupplied after internal resolution and cross-database linking, aggregated per (product, location, unit) and ranked by demanding edges. Each gap carries the blocking reason, the number of consumer edges and distinct consumers, the total demanded amount, and the top consuming processes. Answers 'what is missing to switch or complete this database's background dependency?' - typically read right after a relink.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
limitquerynointegerMax gap entries to return, biggest first (default: all). The header counts always cover the full report, so a truncated list stays countable.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: GapReportAPI -
400Invalid `limit`Invalid `limit`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/quality-report

Operation ID: get_quality_report

Summary: LCA / ACV - dataset-soundness report of a database, for the people who build or repair one: the structural defects a score cannot reveal.

LCA / ACV - dataset-soundness report of a database, for the people who build or repair one: the structural defects a score cannot reveal. All checks run on staged and loaded databases alike: entries without exactly one reference exchange, coproduct allocation percentages that don't sum to 100% (or blocks where only some coproducts carry one), entries duplicated outright (same name, location and reference product), non-finite amounts or a zero reference amount, missing metadata (description, classification, location, units absent from the registry), geography the source never declared - read off the dataset name (SimaPro writes 'Unspecified' in whole databases) or filled in by the loader - stored amounts that disagree with the formulas documenting them (mathematicalRelation, checked at parse time), distinct names that merge under SimaPro's 80-character truncation, exchanges without the pedigree scores their database otherwise carries, reference products nothing in the database consumes (expected for final products), land transformation whose 'to' and 'from' areas don't balance within an activity, oxygen-demand or organic-carbon measures in a physically impossible order (BOD5 above COD, or dissolved above total organic carbon), flow CAS numbers whose check digit does not confirm them, and individual allocation percentages outside the 0-100% range. Each finding carries a severity (danger, warning, info), the activity it was found on, and a readable detail. Answers 'is this dataset well formed?' - the complement of the supplier-gap report, which answers 'what is this database missing?'

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
limitquerynointegerMax findings to return per check, worst first (default: all). Each check's offenderCount always covers its full list, so a truncated list stays countable.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: QualityReportAPI -
400Invalid `limit`Invalid `limit`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/computed-quality-report

Operation ID: get_computed_quality_report

Summary: LCA / ACV - computed-checks report of a LOADED database: what the data computes, judged against the catalogue's own norms.

LCA / ACV - computed-checks report of a LOADED database: what the data computes, judged against the catalogue's own norms. Scores every (activity, product) entry against one method collection (the single loaded one, or the 'collection' parameter) and reports: per-category score outliers, judged on a log scale within (category, reference-unit) groups by median/MAD - a mg-read-as-kg unit slip lands three orders of magnitude out; entries whose every category score is zero (empty or uncharacterized inventory); and negative category scores (info - legitimate where avoided-production credits or waste treatment dominate). Complements get_quality_report, which checks what the database STORES and runs on staged databases too; this one needs the matrices and a loaded method collection. Same finding shape: severity, the entry, a readable detail.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
collectionquerynostringMethod collection to score the catalogue against. Defaults to the single loaded collection; required when several are loaded.
limitquerynointegerMax findings to return per check, worst first (default: all). Each check's offenderCount always covers its full list, so a truncated list stays countable.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ComputedQualityReportAPI -
400Invalid `limit` or `collection`Invalid `limit` or `collection`
404`dbName` not found`dbName` not found

GET /api/v1/db/{dbName}/characterization-coverage

Operation ID: get_characterization_coverage

Summary: LCA / ACV - characterization-coverage report of a database against the loaded LCIA method collections, for the people who maintain databases.

LCA / ACV - characterization-coverage report of a database against the loaded LCIA method collections, for the people who maintain databases. Surfaces the flows a method scores ONLY through a name bridge: VoLCA matches a factor to a flow that carries a different name for the same substance (via synonym or CAS number), so the flow is characterized here - but a tool that matches factors by their exact name has no such bridge and scores it as zero, silently. Each bridged flow is grouped under the name the method itself uses (its rename target). One entry per loaded collection, so two method versions can be compared side by side. Optionally filtered to a single collection. Answers 'which of this database's flow names would an exact-name tool fail to characterize?'

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
collectionquerynostringRestrict the report to one loaded method collection (from list_methods). If omitted, every loaded collection is reported, so two method versions can be compared side by side.
limitquerynointegerMax bridge groups to return per collection (default: all). Each collection's bridgeGroupCount always covers its full list, so a truncated list stays countable.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: CoverageReportAPI -
400Invalid `limit` or `collection`Invalid `limit` or `collection`
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/copy/{newName}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
newNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`dbName` or `newName` not found`dbName` or `newName` not found

DELETE /api/v1/db/{dbName}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/delete

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8DeleteSelectionRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DeleteSelectionResponse -
400Invalid `body`Invalid `body`
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/activity/{processId}/exchanges

Operation ID: edit_exchanges

Summary: LCA / ACV - change what one activity consumes and emits, keeping the activity itself.

LCA / ACV - change what one activity consumes and emits, keeping the activity itself. The only tool that writes data. Use it to adjust an imported dataset to the study at hand: drop a substance the scope excludes, correct an amount, add a supplier the dataset is missing. Everything the edit does not name stays as it is - classification, synonyms, parameters, pedigree, coproducts - which is why this exists rather than rewriting the activity. Only the inventory side is addressable: an input by its provider's process_id, a waste output by its treatment's process_id, a biosphere line by its flow id (from get_activity). The reference product and any coproduct are not reachable, because changing those changes what the activity IS. A selector that matches nothing is refused rather than silently doing nothing, and one that matches several lines edits all of them and says how many. Refused outright on a database the engine reads from its configuration: copy it first (that background data is shared with everyone). If the answer says transient, the edit is in memory only and an unload undoes it.

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
processIdpathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8ExchangeEditRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ExchangeEditResponse -
400Invalid `body`Invalid `body`
404`dbName` or `processId` not found`dbName` or `processId` not found

POST /api/v1/db/{dbName}/export

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8ExportRequest

Responses

StatusSchemaDescription
200application/octet-stream: OctetStream -
400Invalid `body`Invalid `body`
404`dbName` not found`dbName` not found

POST /api/v1/db/upload

Parameters

NameInRequiredTypeDescription
namequerynostring -
descriptionquerynostring -

Request body

Media typeSchema
application/octet-streamUploadChunk[]

Responses

StatusSchemaDescription
200application/json;charset=utf-8: UploadResponse -
400Invalid `body` or `description` or `name`Invalid `body` or `description` or `name`

GET /api/v1/db/{dbName}/setup

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DatabaseSetupInfo -
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/add-dependency/{depName}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
depNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DatabaseSetupInfo -
404`dbName` or `depName` not found`dbName` or `depName` not found

POST /api/v1/db/{dbName}/remove-dependency/{depName}

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -
depNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DatabaseSetupInfo -
404`dbName` or `depName` not found`dbName` or `depName` not found

POST /api/v1/db/{dbName}/set-data-path

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8JsonValue

Responses

StatusSchemaDescription
200application/json;charset=utf-8: DatabaseSetupInfo -
400Invalid `body`Invalid `body`
404`dbName` not found`dbName` not found

POST /api/v1/db/{dbName}/finalize

Parameters

NameInRequiredTypeDescription
dbNamepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`dbName` not found`dbName` not found

GET /api/v1/method-collections

Responses

StatusSchemaDescription
200application/json;charset=utf-8: MethodCollectionListResponse -

POST /api/v1/method-collections/{name}/load

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/method-collections/{name}/unload

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

DELETE /api/v1/method-collections/{name}

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/method-collections/upload

Parameters

NameInRequiredTypeDescription
namequerynostring -
descriptionquerynostring -

Request body

Media typeSchema
application/octet-streamUploadChunk[]

Responses

StatusSchemaDescription
200application/json;charset=utf-8: UploadResponse -
400Invalid `body` or `description` or `name`Invalid `body` or `description` or `name`

POST /api/v1/method-collections/{name}/export

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Request body

Media typeSchema
application/json;charset=utf-8ExportRequest

Responses

StatusSchemaDescription
200application/octet-stream: OctetStream -
400Invalid `body`Invalid `body`
404`name` not found`name` not found

GET /api/v1/flow-synonyms

Responses

StatusSchemaDescription
200application/json;charset=utf-8: RefDataListResponse -

POST /api/v1/flow-synonyms/{name}/load

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/flow-synonyms/{name}/unload

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

DELETE /api/v1/flow-synonyms/{name}

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/flow-synonyms/upload

Parameters

NameInRequiredTypeDescription
namequerynostring -
descriptionquerynostring -

Request body

Media typeSchema
application/octet-streamUploadChunk[]

Responses

StatusSchemaDescription
200application/json;charset=utf-8: UploadResponse -
400Invalid `body` or `description` or `name`Invalid `body` or `description` or `name`

GET /api/v1/flow-synonyms/{name}/groups

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: SynonymGroupsResponse -
404`name` not found`name` not found

GET /api/v1/flow-synonyms/{name}/download

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/octet-stream: OctetStream -
404`name` not found`name` not found

GET /api/v1/compartment-mappings

Responses

StatusSchemaDescription
200application/json;charset=utf-8: RefDataListResponse -

POST /api/v1/compartment-mappings/{name}/load

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/compartment-mappings/{name}/unload

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

DELETE /api/v1/compartment-mappings/{name}

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/compartment-mappings/upload

Parameters

NameInRequiredTypeDescription
namequerynostring -
descriptionquerynostring -

Request body

Media typeSchema
application/octet-streamUploadChunk[]

Responses

StatusSchemaDescription
200application/json;charset=utf-8: UploadResponse -
400Invalid `body` or `description` or `name`Invalid `body` or `description` or `name`

GET /api/v1/units

Responses

StatusSchemaDescription
200application/json;charset=utf-8: RefDataListResponse -

POST /api/v1/units/{name}/load

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/units/{name}/unload

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

DELETE /api/v1/units/{name}

Parameters

NameInRequiredTypeDescription
namepathyesstring -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ActivateResponse -
404`name` not found`name` not found

POST /api/v1/units/upload

Parameters

NameInRequiredTypeDescription
namequerynostring -
descriptionquerynostring -

Request body

Media typeSchema
application/octet-streamUploadChunk[]

Responses

StatusSchemaDescription
200application/json;charset=utf-8: UploadResponse -
400Invalid `body` or `description` or `name`Invalid `body` or `description` or `name`

GET /api/v1/logs

Parameters

NameInRequiredTypeDescription
sincequerynointeger -

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -
400Invalid `since`Invalid `since`

POST /api/v1/auth

Request body

Media typeSchema
application/json;charset=utf-8LoginRequest

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -
400Invalid `body`Invalid `body`

GET /api/v1/version

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -

GET /api/v1/hosting

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -

GET /api/v1/stats

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -

GET /api/v1/classification-presets

Operation ID: list_presets

Summary: LCA / ACV - list named classification filter presets configured in this instance.

LCA / ACV - list named classification filter presets configured in this instance. Each preset bundles multiple (system, value, mode) classification filters under a human-readable label. Use the filter values from a preset as inputs to search_activities classification parameters.

Responses

StatusSchemaDescription
200application/json;charset=utf-8: ClassificationPresetInfo[] -

GET /api/v1/openapi.json

Responses

StatusSchemaDescription
200application/json;charset=utf-8: JsonValue -

ActivityInfo

Type: object

PropertyRequiredTypeDescription
activityyesActivityForAPI -
linksyesActivityLinks -
metadatayesActivityMetadata -
statisticsyesActivityStats -

ActivityForAPI

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
allProductsyesActivitySummary[] -
classificationsyesobject -
descriptionyesstring[] -
exchangesyesExchangeWithUnit[] -
locationyesstring -
nativeTypenoNativeActivityType -
processIdyesstring -
productAmountnonumber -
productNamenostring -
productUnitnostring -
synonymsyesobject -
unityesstring -

ActivitySummary

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
allocationFormulanostring -
allocationPercentnonumber -
locationyesstring -
nativeTypenoNativeActivityType -
processIdyesstring -
productAmountyesnumber -
productNameyesstring -
productUnityesstring -

NativeActivityType

Type: object

PropertyRequiredTypeDescription
codenointeger -
labelyesstring -
sourceyesstringAllowed values: ecospold2, simapro, ilcd
special_codenointeger -
special_labelnostring -

ExchangeWithUnit

Type: object

PropertyRequiredTypeDescription
compartmentnoCompartment -
exCommentnostring -
exchangeyesExchange -
flowNameyesstring -
pedigreenoPedigree -
targetActivityNamenostring -
targetLocationnostring -
targetProcessIdnostring -
unitNameyesstring -

Exchange

Type: oneOf(object | object | object)

UUID

Type: string

TechRole

Type: string

Allowed values: ReferenceProduct, Coproduct, ReferenceInput, Input

Pedigree

Type: object

PropertyRequiredTypeDescription
completenessyesinteger -
geographicalyesinteger -
reliabilityyesinteger -
technologicalyesinteger -
temporalyesinteger -

BioDirection

Type: string

Allowed values: Resource, Emission

Compartment

Type: object

PropertyRequiredTypeDescription
nameyesstring -
subnostring -

ActivityMetadata

Type: object

PropertyRequiredTypeDescription
biosphereExchangesyesinteger -
hasReferenceProductyesboolean -
referenceProductFlownoUUID -
technosphereInputsyesinteger -
totalFlowsyesinteger -
wasteExchangesLinkedyesinteger -
wasteExchangesOrphanyesinteger -

ActivityStats

Type: object

PropertyRequiredTypeDescription
inputCountyesinteger -
locationyesstring -
outputCountyesinteger -
totalExchangesyesinteger -

ActivityLinks

Type: object

PropertyRequiredTypeDescription
flowsUrlyesstring -
inputsUrlyesstring -
outputsUrlyesstring -
referenceProductUrlnostring -

FlowSummary

Type: object

PropertyRequiredTypeDescription
flowyesApiFlow -
roleyesFlowRole -
unitNameyesstring -
usageCountyesinteger -

ApiFlow

Type: oneOf(object | object | object)

PropertyRequiredTypeDescription
kindyesstringAllowed values: technosphere, biosphere, unresolved

TechnosphereFlow

Type: object

PropertyRequiredTypeDescription
cASnostring -
idyesUUID -
nameyesstring -
substanceIdnointeger -
synonymsyesobject -
unitIdyesUUID -

BiosphereFlow

Type: object

PropertyRequiredTypeDescription
cASnostring -
compartmentnoCompartment -
idyesUUID -
nameyesstring -
substanceIdnointeger -
synonymsyesobject -
unitIdyesUUID -

FlowRole

Type: string

Allowed values: InputFlow, OutputFlow, ReferenceProductFlow

ExchangeDetail

Type: object

PropertyRequiredTypeDescription
exchangeyesExchange -
exchangeUnitNameyesstring -
flowyesApiFlow -
flowUnitNameyesstring -
targetActivitynoActivitySummary -
unityesUnit -

Unit

Type: object

PropertyRequiredTypeDescription
commentyesstring -
idyesUUID -
nameyesstring -
symbolyesstring -

FlowDetail

Type: object

PropertyRequiredTypeDescription
flowyesApiFlow -
unitNameyesstring -
usageCountyesinteger -

TreeExport

Type: object

PropertyRequiredTypeDescription
edgesyesTreeEdge[] -
nodesyesobject -
treeyesTreeMetadata -

TreeMetadata

Type: object

PropertyRequiredTypeDescription
expandableNodesyesinteger -
leafNodesyesinteger -
loopNodesyesinteger -
maxDepthyesinteger -
rootIdyesstring -
totalNodesyesinteger -

ExportNode

Type: object

PropertyRequiredTypeDescription
childrenCountyesinteger -
compartmentnostring -
depthyesinteger -
descriptionyesstring[] -
idyesstring -
locationyesstring -
loopTargetnostring -
nameyesstring -
nodeTypeyesNodeType -
parentIdnostring -
unityesstring -

NodeType

Type: string

Allowed values: ActivityNode, LoopNode, BiosphereEmissionNode, BiosphereResourceNode

TreeEdge

Type: object

PropertyRequiredTypeDescription
edgeTypeyesEdgeType -
flowyesFlowInfo -
fromyesstring -
quantityyesnumber -
toyesstring -
unityesstring -

FlowInfo

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
idyesUUID -
nameyesstring -

EdgeType

Type: string

Allowed values: TechnosphereEdge, BiosphereEmissionEdge, BiosphereResourceEdge

InventoryExport

Type: object

PropertyRequiredTypeDescription
flowsyesInventoryFlowDetail[] -
metadatayesInventoryMetadata -
statisticsyesInventoryStatistics -

InventoryMetadata

Type: object

PropertyRequiredTypeDescription
emissionFlowsyesinteger -
resourceFlowsyesinteger -
rootActivityyesActivitySummary -
totalFlowsyesinteger -

InventoryFlowDetail

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
flowyesBiosphereFlow -
isEmissionyesboolean -
quantityyesnumber -
unitNameyesstring -

InventoryStatistics

Type: object

PropertyRequiredTypeDescription
emissionQuantityyesnumber -
resourceQuantityyesnumber -
topCategoriesyesobject[][] -
totalQuantityyesnumber -

GraphExport

Type: object

PropertyRequiredTypeDescription
edgesyesGraphEdge[] -
nodesyesGraphNode[] -
unitGroupsyesobject -

GraphNode

Type: object

PropertyRequiredTypeDescription
labelyesstring -
locationyesstring -
nodeIdyesinteger -
processIdyesstring -
unityesstring -
valueyesnumber -

GraphEdge

Type: object

PropertyRequiredTypeDescription
flowNameyesstring -
sourceyesinteger -
targetyesinteger -
unityesstring -
valueyesnumber -

SupplyChainResponse

Type: object

PropertyRequiredTypeDescription
edgesyesSupplyChainEdge[] -
filteredActivitiesyesinteger -
rootyesActivitySummary -
supplyChainyesSupplyChainEntry[] -
totalActivitiesyesinteger -

SupplyChainEntry

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
classificationsyesobject -
databaseNameyesstring -
depthyesinteger -
locationyesstring -
processIdyesstring -
quantityyesnumber -
scalingFactoryesnumber -
unityesstring -
upstreamCountyesinteger -

SupplyChainEdge

Type: object

PropertyRequiredTypeDescription
edgeAmountyesnumber -
edgeFromyesstring -
edgeFromDbyesstring -
edgeToyesstring -
edgeToDbyesstring -

Aggregation

Type: object

PropertyRequiredTypeDescription
filteredCountyesinteger -
filteredTotalyesnumber -
filteredUnitnostring -
groupsyesAggregationGroup[] -
scopeyesstring -

AggregationGroup

Type: object

PropertyRequiredTypeDescription
countyesinteger -
keyyesstring -
quantityyesnumber -
sharenonumber -
unitnostring -

LCIABatchResult

Type: object

PropertyRequiredTypeDescription
availableNWsetsyesstring[] -
cutoffWasteyesCutoffWasteFlow[] -
normWeightSetNamenostring -
resultsyesLCIAResult[] -
scoringIndicatorsyesobject -
scoringResultsyesobject -
scoringUnitsyesobject -
singleScorenonumber -
singleScoreUnitnostring -

LCIAResult

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
damageCategoryyesstring -
functionalUnityesstring -
mappedFlowsyesinteger -
methodIdyesUUID -
methodNameyesstring -
normalizedScorenonumber -
scoreyesnumber -
topContributorsyesFlowContributionEntry[] -
unityesstring -
weightedScorenonumber -

FlowContributionEntry

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
cfValueyesnumber -
compartmentnostring -
contributionyesnumber -
flowIdyesstring -
flowNameyesstring -
matchKindnostring -
sharePctyesnumber -

ScoringIndicator

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
valueyesnumber -

CutoffWasteFlow

Type: object

PropertyRequiredTypeDescription
amountyesnumber -
flowIdyesUUID -
flowNameyesstring -
unityesstring -

SubstitutionRequest

Type: object

PropertyRequiredTypeDescription
substitutionsyesSubstitution[] -

Substitution

Type: object

PropertyRequiredTypeDescription
consumernostring -
fromyesstring -
toyesstring -

SensitivityResponse

Type: object

PropertyRequiredTypeDescription
baselineyesLCIAResult -
perturbedyesPerturbedEntry[] -

PerturbedEntry

Type: object

PropertyRequiredTypeDescription
deltaImpactnonumber -
errornostring -
impactnoLCIAResult -
perturbationyesPerturbation -

Perturbation

Type: object

PropertyRequiredTypeDescription
consumeryesstring -
deltayesnumber -
labelnostring -
supplieryesstring -

SensitivityRequest

Type: object

PropertyRequiredTypeDescription
perturbationsyesPerturbation[] -

ConsumersResponse

Type: object

PropertyRequiredTypeDescription
edgesyesSupplyChainEdge[] -
resultsyesSearchResults_ConsumerResult -

SearchResults_ConsumerResult

Type: object

PropertyRequiredTypeDescription
hasMoreyesboolean -
limityesinteger -
offsetyesinteger -
resultsyesConsumerResult[] -
searchTimeMsyesnumber -
totalyesinteger -

ConsumerResult

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
classificationsyesobject -
depthyesinteger -
locationyesstring -
processIdyesstring -
productAmountyesnumber -
productNameyesstring -
productUnityesstring -

JsonValue

Type: object

ContributingFlowsResult

Type: object

PropertyRequiredTypeDescription
methodyesstring -
topFlowsyesFlowContributionEntry[] -
totalScoreyesnumber -
unityesstring -

ContributingActivitiesResult

Type: object

PropertyRequiredTypeDescription
activitiesyesActivityContribution[] -
methodyesstring -
totalScoreyesnumber -
unityesstring -

ActivityContribution

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
contributionyesnumber -
locationyesstring -
processIdyesstring -
productNameyesstring -
sharePctyesnumber -

MethodSummary

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
collectionyesstring -
factorCountyesinteger -
idyesUUID -
nameyesstring -
unityesstring -

MethodDetail

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
descriptionnostring -
factorCountyesinteger -
idyesUUID -
methodologynostring -
nameyesstring -
unityesstring -

MethodFactorAPI

Type: object

PropertyRequiredTypeDescription
compartmentnostring -
directionyesstring -
flowNameyesstring -
flowRefyesUUID -
locationnostring -
unitnostring -
valueyesnumber -

MappingStatus

Type: object

PropertyRequiredTypeDescription
coverageyesnumber -
dbBiosphereCountyesinteger -
mappedByCASyesinteger -
mappedByNameyesinteger -
mappedBySynonymyesinteger -
mappedByUUIDyesinteger -
methodIdyesUUID -
methodNameyesstring -
totalFactorsyesinteger -
uniqueDbFlowsMatchedyesinteger -
unmappedyesinteger -
unmappedFlowsyesUnmappedFlowAPI[] -

UnmappedFlowAPI

Type: object

PropertyRequiredTypeDescription
directionyesstring -
flowNameyesstring -
flowRefyesUUID -

FlowCFMapping

Type: object

PropertyRequiredTypeDescription
flowsyesFlowCFEntry[] -
matchedFlowsyesinteger -
methodNameyesstring -
methodUnityesstring -
totalFlowsyesinteger -

FlowCFEntry

Type: object

PropertyRequiredTypeDescription
cfFlowNamenostring -
cfValuenonumber -
flowCategoryyesstring -
flowIdyesUUID -
flowNameyesstring -
matchStrategynostring -

CollectionCoverage

Type: object

PropertyRequiredTypeDescription
characterizedFlowsyesinteger -
collectionyesstring -
dbNameyesstring -
totalFlowsyesinteger -

CharacterizationResult

Type: object

PropertyRequiredTypeDescription
factorsyesCharacterizationEntry[] -
matchesyesinteger -
methodyesstring -
shownyesinteger -
unityesstring -

CharacterizationEntry

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
cfUnityesstring -
cfValueyesnumber -
compartmentnostring -
dbFlowNameyesstring -
directionyesstring -
flowIdyesstring -
flowUnityesstring -
matchStrategyyesstring -
methodFlowNameyesstring -

ExplainCFResult

Type: object

PropertyRequiredTypeDescription
explanationyesstring[] -
flowyesExplainedFlowAPI -
matchnoExplainedMatchAPI -
methodyesstring -
methodUnityesstring -
outcomeyesstring -
regionalFactorCountyesinteger -
stepsTriedyesExplainedStepAPI[] -

ExplainedFlowAPI

Type: object

PropertyRequiredTypeDescription
casnostring -
categoryyesstring -
compartmentnostring -
idyesstring -
nameyesstring -
unityesstring -

ExplainedMatchAPI

Type: object

PropertyRequiredTypeDescription
cfUnityesstring -
cfValueyesnumber -
matchStrategyyesstring -
methodCasnostring -
methodFlowNameyesstring -
refusalnostring -
rungyesstring -
unitConversionnostring -

ExplainedStepAPI

Type: object

PropertyRequiredTypeDescription
resultyesstring -
rungyesstring -
vetonostring -

SearchResults_FlowSearchResult

Type: object

PropertyRequiredTypeDescription
hasMoreyesboolean -
limityesinteger -
offsetyesinteger -
resultsyesFlowSearchResult[] -
searchTimeMsyesnumber -
totalyesinteger -

FlowSearchResult

Type: object

PropertyRequiredTypeDescription
categoryyesstring -
compartmentnostring -
idyesUUID -
nameyesstring -
synonymsyesobject -
unitNameyesstring -

SearchResults_ActivitySummary

Type: object

PropertyRequiredTypeDescription
hasMoreyesboolean -
limityesinteger -
offsetyesinteger -
resultsyesActivitySummary[] -
searchTimeMsyesnumber -
totalyesinteger -

ClassificationSystem

Type: object

PropertyRequiredTypeDescription
activityCountyesinteger -
nameyesstring -
valuesyesstring[] -

BatchImpactsResponse

Type: object

PropertyRequiredTypeDescription
invalidyesstring[] -
notFoundyesstring[] -
resultsyesBatchImpactsEntry[] -

BatchImpactsEntry

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
impactsyesLCIABatchResult -
processIdyesstring -

BatchImpactsRequest

Type: object

PropertyRequiredTypeDescription
processIdsyesstring[] -

DatabaseListResponse

Type: object

PropertyRequiredTypeDescription
databasesyesDatabaseStatusAPI[] -

DatabaseStatusAPI

Type: object

PropertyRequiredTypeDescription
activityCountyesinteger -
dependsOnyesstring[] -
descriptionnostring -
displayNameyesstring -
formatnostring -
isUploadedyesboolean -
loadAtStartupyesboolean -
nameyesstring -
pathyesstring -
statusyesstring -

LoadDatabaseResponse

Type: oneOf(object | object)

DepLoadResult

Type: oneOf(object | object)

ActivateResponse

Type: object

PropertyRequiredTypeDescription
databasenoDatabaseStatusAPI -
messageyesstring -
successyesboolean -

RelinkResponse

Type: object

PropertyRequiredTypeDescription
crossDBLinksyesinteger -
dbNameyesstring -
dependsOnyesstring[] -
unresolvedAfteryesinteger -
unresolvedBeforeyesinteger -

RelinkRequest

Type: object

PropertyRequiredTypeDescription
depDbnostring -
mappingCsvnostring -

GapReportAPI

Type: object

PropertyRequiredTypeDescription
completenessyesnumber -
crossDBLinksyesinteger -
dbNameyesstring -
gapsyesGapEntryAPI[] -
internalLinksyesinteger -
totalInputsyesinteger -
unresolvedEdgesyesinteger -
unresolvedProductsyesinteger -

GapEntryAPI

Type: object

PropertyRequiredTypeDescription
consumersyesinteger -
demandSumyesnumber -
detailnostring -
edgesyesinteger -
locationyesstring -
nameyesstring -
reasonyesstring -
topConsumersyesGapConsumerAPI[] -
unityesstring -

GapConsumerAPI

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
edgesyesinteger -
locationyesstring -
processIdyesstring -
productNameyesstring -

QualityReportAPI

Type: object

PropertyRequiredTypeDescription
allocationOutOfRangeyesQualityCheckAPI -
allocationSumsyesQualityCheckAPI -
dbNameyesstring -
duplicateActivitiesyesQualityCheckAPI -
formulaConsistencyyesQualityCheckAPI -
invalidCasyesQualityCheckAPI -
landTransformationBalanceyesQualityCheckAPI -
missingMetadatayesQualityCheckAPI -
missingPedigreeyesQualityCheckAPI -
oxygenDemandOrderyesQualityCheckAPI -
processCountyesinteger -
referenceProductyesQualityCheckAPI -
suspiciousAmountsyesQualityCheckAPI -
truncatedNameCollisionsyesQualityCheckAPI -
unconsumedProductsyesQualityCheckAPI -
undeclaredGeographyyesQualityCheckAPI -
unmeasurableAmountsyesQualityCheckAPI -

QualityCheckAPI

Type: object

PropertyRequiredTypeDescription
applicableyesboolean -
offenderCountyesinteger -
offendersyesQualityOffenderAPI[] -

QualityOffenderAPI

Type: object

PropertyRequiredTypeDescription
activityNameyesstring -
detailyesstring -
locationyesstring -
processIdyesstring -
productNamenostring -
severityyesSeverity -

Severity

Type: string

Allowed values: danger, warning, info

ComputedQualityReportAPI

Type: object

PropertyRequiredTypeDescription
collectionyesstring -
dbNameyesstring -
negativeScoresyesQualityCheckAPI -
processCountyesinteger -
scoreOutliersyesQualityCheckAPI -
zeroScoresyesQualityCheckAPI -

CoverageReportAPI

Type: object

PropertyRequiredTypeDescription
collectionsyesCollectionBridgesAPI[] -
dbNameyesstring -

CollectionBridgesAPI

Type: object

PropertyRequiredTypeDescription
bridgeGroupCountyesinteger -
bridgeGroupsyesBridgeGroupAPI[] -
characterizedFlowsyesinteger -
collectionyesstring -
totalFlowsyesinteger -

BridgeGroupAPI

Type: object

PropertyRequiredTypeDescription
bridgedFlowsyesBridgedFlowAPI[] -
casnostring -
methodNameyesstring -

BridgedFlowAPI

Type: object

PropertyRequiredTypeDescription
flowNameyesstring -
strategyyesstring -

DeleteSelectionResponse

Type: object

PropertyRequiredTypeDescription
deletedyesinteger -
messageyesstring -
successyesboolean -
transientyesboolean -
warningsyesstring[] -

DeleteSelectionRequest

Type: object

PropertyRequiredTypeDescription
classificationsyesDeleteClassFilter[] -
exactnoboolean -
extrayesstring[] -
idsnostring[] -
keepyesstring[] -
locationnostring -
namenostring -
productnostring -

DeleteClassFilter

Type: object

PropertyRequiredTypeDescription
exactyesboolean -
systemyesstring -
valueyesstring -

ActivityWriteResponse

Type: object

PropertyRequiredTypeDescription
transientyesboolean -
warningsyesstring[] -
writtenyesstring[] -

ActivityWriteRequest

Type: object

PropertyRequiredTypeDescription
activitiesyesActivityInput[] -

ActivityInput

Type: object

PropertyRequiredTypeDescription
biosphereyesBioExchangeAPI[] -
descriptionyesstring[] -
inputsyesTechInputAPI[] -
locationyesstring -
nameyesstring -
productAmountyesnumber -
productNameyesstring -
productUnityesstring -
wasteOutputsyesWasteOutputAPI[] -

TechInputAPI

Type: object

PropertyRequiredTypeDescription
amountyesnumber -
commentnostring -
provideryesstring -
unitnostring -

BioExchangeAPI

Type: object

PropertyRequiredTypeDescription
amountyesnumber -
commentnostring -
compartmentnostring -
directionyesstring -
flownostring -
namenostring -
subCompartmentnostring -
unitnostring -

WasteOutputAPI

Type: object

PropertyRequiredTypeDescription
amountyesnumber -
commentnostring -
provideryesstring -
unitnostring -

ExchangeEditResponse

Type: object

PropertyRequiredTypeDescription
addedyesinteger -
amountsSetyesinteger[] -
removedyesinteger[] -
transientyesboolean -
warningsyesstring[] -

ExchangeEditRequest

Type: object

PropertyRequiredTypeDescription
addBiosphereyesBioExchangeAPI[] -
addInputsyesTechInputAPI[] -
addWasteOutputsyesWasteOutputAPI[] -
removeyesExchangeSelectorAPI[] -
setAmountsyesSetAmountAPI[] -

ExchangeSelectorAPI

Type: object

PropertyRequiredTypeDescription
flownostring -
kindyesstring -
providernostring -

SetAmountAPI

Type: object

PropertyRequiredTypeDescription
amountyesnumber -
selectyesExchangeSelectorAPI -

OctetStream

Type: string

ExportRequest

Type: object

PropertyRequiredTypeDescription
formatyesstring -

UploadResponse

Type: object

PropertyRequiredTypeDescription
formatnostring -
messageyesstring -
slugnostring -
successyesboolean -

UploadChunk

Type: string

DatabaseSetupInfo

Type: object

PropertyRequiredTypeDescription
activityCountyesinteger -
attributeFallbacksyesAttributeFallback[] -
availablePathsyesPathCandidate[] -
completenessyesnumber -
crossDBLinksyesinteger -
dataPathyesstring -
dependenciesyesDependencyChoice[] -
displayNameyesstring -
inputCountyesinteger -
internalLinksyesinteger -
isLoadedyesboolean -
isReadyyesboolean -
locationFallbacksyesLocationFallback[] -
locationUnresolvedyesLocationUnresolved[] -
missingSuppliersyesMissingSupplier[] -
nameyesstring -
unknownUnitsyesstring[] -
unresolvedLinksyesinteger -

MissingSupplier

Type: object

PropertyRequiredTypeDescription
countyesinteger -
detailnostring -
locationnostring -
productNameyesstring -
reasonyesstring -

DependencyChoice

Type: object

PropertyRequiredTypeDescription
databaseNameyesstring -
displayNameyesstring -
matchCountyesinteger -
statusyesDependencyStatus -

DependencyStatus

Type: string

Allowed values: selected, available, redundant

LocationFallback

Type: object

PropertyRequiredTypeDescription
actualyesstring -
kindyesLocationKind -
productyesstring -
requestedyesstring -

LocationKind

Type: string

Allowed values: exact, parent, global, unrelated

LocationUnresolved

Type: object

PropertyRequiredTypeDescription
productyesstring -
reasonyesstring -
requestedyesstring -

AttributeFallback

Type: object

PropertyRequiredTypeDescription
matchedyesstring -
productyesstring -
requestedyesstring -
sourceDatabaseyesstring -

PathCandidate

Type: object

PropertyRequiredTypeDescription
fileCountyesinteger -
formatyesstring -
pathyesstring -

MethodCollectionListResponse

Type: object

PropertyRequiredTypeDescription
methodsyesMethodCollectionStatusAPI[] -

MethodCollectionStatusAPI

Type: object

PropertyRequiredTypeDescription
descriptionnostring -
displayNameyesstring -
formatnostring -
isUploadedyesboolean -
methodCountyesinteger -
nameyesstring -
pathyesstring -
statusyesstring -

RefDataListResponse

Type: object

PropertyRequiredTypeDescription
itemsyesRefDataStatusAPI[] -

RefDataStatusAPI

Type: object

PropertyRequiredTypeDescription
descriptionnostring -
displayNameyesstring -
entryCountyesinteger -
isAutoyesboolean -
isUploadedyesboolean -
nameyesstring -
statusyesstring -

SynonymGroupsResponse

Type: object

PropertyRequiredTypeDescription
groupsyesstring[][] -

LoginRequest

Type: object

PropertyRequiredTypeDescription
lrCodeyesstring -

ClassificationPresetInfo

Type: object

PropertyRequiredTypeDescription
descriptionnostring -
filtersyesClassificationEntryInfo[] -
labelyesstring -
nameyesstring -

ClassificationEntryInfo

Type: object

PropertyRequiredTypeDescription
modeyesstring -
systemyesstring -
valueyesstring -