Datasets

Datasets are the original source of impact data (emission factors). They can come from databases like ecoinvent, be shared by other companies, or be created by the user. The /v1/dataset endpoint lists datasets in your account - ones you’ve added from the Variable Database, created yourself, or received from a supplier. This is different from the /v1/database (search) endpoint, which searches the global Variable Database.

​

How datasets relate to products and materials

A Product (LCA) is a modeled footprint - it has a bill of materials with Inputs. A Material gets its impacts by referencing a Dataset directly. See Products & Materials for more.

​

Binding a dataset to an element

A sourced element — a material, energy, or process — that draws its impact from a single dataset is an external element (dataSource: external). Create or update one through the API (/v1/material, /v1/energy, /v1/process) or MCP and bind its dataset by sending dataset: { uuid }; binding one makes the element external. Add datasetAmount to set the quantity its per-unit factor scales, or omit it to consume one declared unit of the dataset. Sending a different dataset on update re-points the element. Use database search to find a dataset to bind.

​

Attributes

​

Footprint

The footprint.CO2e object holds the CO₂e values for the dataset. See Products & Materials for the full footprint structure.