Product Carbon Footprint Endpoint version: V1 (preview 2)V1 (preview 2) ADD-ONADD-ON

🚫

Private Preview

This feature is currently in private preview. They may change without warning. Do not share this documentation outside of your company.

Climatiq’s Product Carbon Footprint(PCF) feature helps automate the emissions associated with product manufacturing, covering material sourcing and factory production.

The PCF feature is designed for scenarios where you are manufacturing a physical product and have the following data available:

The location of manufacturing site
A detailed bill of materials (BOM) for the final manufactured product, including the origin of each component
The energy uses for the manufacturing of the final product
The year of manufacture

For the limitations of the current version of the feature, see limitations.

User Guide

This endpoint has been designed with composability in mind. A PCF is modeled as a tree, and the tree can contain three different kinds of components.

Simple Components

The simplest component is a Simple Component, that is just a string describing the component, a weight of the component and some additional metadata. If you are producing a hammer, that could e.g. be “Wood” and “Iron” for the handle and the head.

Simple Components are good if you have limited amount of data about the input component into your PCF. It uses Climatiq’s autopilot to try and find the best emission factor for your input string.

graph (Simple components are in green in the above picture)

Product References

In the example above, perhaps you actually have significantly more details about parts of your product, e.g. if you are smelting the hammer heads yourself. In a case like that, you can add more details, by creating a PCF for just the hammer head, and explicitly specifying the energy required to smelt the raw iron into the correct shape.

When you create a component, you must specify an ID that you can use to reference it later. Currently, the ID field is not optional, it might become so in the future.

In this case, we would define a PCF for the hammer head:

graph

And then reference that in the hammer PCF:

graph

Currently if you need to use the same PCF multiple times in another PCF (e.g. you have a PCF for a tire and you’re constructing a car, you must create 4 separate references. We are working on making this nicer.

⚠️

Ephemeral persistence

Note that, while this version currently persists estimated PCFs, the storage used has not yet been stabilized and may be wiped without prior notice. Expect 404 errors when referencing previously estimated PCFs.

Product Variations

The last important concept, is the concept of “variations”. It is common to purchase things from several different suppliers and countries, and then treat them as one for production. E.g. if you buy iron for your hammer heads in two different countries, and then afterward keep the iron in the same storage facility.

In this case, you might know that you get 70% of your iron ingot from Australia and the last 30% from Brazil. You would create a Variations object with both of these Simple Components inside it, and apply a ratio to each. The endpoint then automatically handles picking the correct emission factors, transportation from both locations, and correctly averaging out the results

graph

Estimate

POST This endpoint allows you to calculate a Product Carbon Footprint for a product using your manufacturing and component data.

The Product Carbon Footprint estimate includes:

Component production emissions: Calculates emissions associated with the production of components and materials. Emission factors are automatically determined using the Autopilot feature. Autopilot will also choose from your private emisssion factors, if you have enabled this add-on feature (note that recently added private factors may not be considered by Autopilot right away). If you have a premium data license for e.g. ecoinvent, these factors will also be considered as candidates.
Logistics emissions: Estimates emissions from transporting components using the Freight feature.
Manufacturing electricity emissions: Calculates emissions from electricity consumption during the final manufacturing step, using the Energy feature. If you have a premium license for IEA data, these emission factors will also be used.
Data Quality Rating: A numerical score is returned to indicate the accuracy of the results.

An estimate is saved under the ID that you assign it when calling the /estimate endpoint. It can be referenced in subsequent calls to /estimate, so you can reuse them to build complex chains of products.

Request

This endpoint accepts the following parameters:

Request headersRequired HTTP headers for this request

Authorizationrequired string
Bearer token containing your Climatiq API key. Example: Authorization: Bearer CLIMATIQ_API_KEY
Don't have an API key? Get your API key here.

Request parametersShould be sent as a JSON object in the body

productrequired string
The name of the product being produced. Currently, this field is used for descriptive purposes. In future updates, Climatiq may integrate the Autopilot feature to automatically map products to emission factors. See here for what a good input to this field is.
locationrequired object
The location where the product was manufactured. Accepts Location String, Query Location, IATA Code Location, UN/LOCODE Location or Coordinate Location
manufacturing_yearrequired number
The year the product is manufactured.
manufacturingrequired array of manufacturing objects
Components of energy used for the manufacturing process.
simple_component_production_data_sourcesarray of strings
This parameter allows you to set a list of data sources that autopilot will consider when selecting emission factors for this request. If this parameter is not given, the default list of PCF-relevant sources will be considered.
componentsrequired array of Product Reference, SimpleComponent or Variations (freely mixed)
An array of the components used to produce this product.
weightWeight
Default value: The weight of all input components summed up
If you want to specify the weight of the final product, you may do so here. This can be relevant when e.g. handling packaging
Default Value
The weight of all input components summed up
use_phasearray of Use-phase emissions (freely mixed)
Optional array of use-phase emissions. This allows you to specify emissions generated during the use-phase of the product.
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.

Product Reference

A Product Reference is a reference to a product you have previously estimated using the /estimate endpoint. Its emissions, weight and location will be called up from our database and go into the current estimation. If the current estimation’s location is different from that of the reference, the referenced product will come with a transportation estimate and emissions.

A Product Reference has the following attributes:

typerequired string
Value must be "reference"
idrequired string
The ID of a previously estimated product.
transportation_modestring
If known, what the primary transportation mode for this component was. Valid values are "air", "sea", "rail", or "road". If not provided, Climatiq will heuristically determine the most likely transportation mode.
multiplierobject of type Weight or Number
If you need a certain amount of this product, e.g. four tires to a car, you can specify this field with a multiplier ({ "number": 4.0 } in this example) or specify a certain weight for products that cannot easily be counted, e.g. { "weight": 1, "weight_unit": "t" }. The weight, production and transportation emissions (if any) will be scaled according to the multiplier specified. Note that the referenced product itself will not be changed, only its use in this estimation will be scaled.

Simple Component

A Simple Component is, contrary to a Product Reference, a component that you have little information about or don’t care to set up as a product itself. We will utilize the Autopilot feature to find emissions for producing the component, as well as the Freight feature for transportation it to the manufacturing site, if applicable.

A simple component has the following attributes:

typerequired string
Value must be "simple"
productrequired string
What the component is. This will be used by the Autopilot feature to find a suitable emission factor to estimate emissions.
weightrequired Weight object
The weight of the needed component. Used both in estimating the emissions for procuring the component, as well as transporting it to the site of manufacture, if applicable. The weight must be positive.
locationobject
The location where the component is procured from. Accepts Location String, Query Location, IATA Code Location, UN/LOCODE Location or Coordinate Location. If omitted, no freight emissions will be calculated for this component, and emission factor selection will not filter by region. A warning notice will be returned.
production_yearrequired number
The year the component was produced.
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.
transportation_modestring
If known, what the primary transportation mode for this component was. Valid values are "air", "sea", "rail", or "road". If not provided, Climatiq will heuristically determine the most likely transportation mode.
emission_factorA Selector
If you specify this parameter, it will be used to select an emission factor for the production of this component, instead of autopilot. This also allows you to use your private emission factors.
end_of_lifeobject
End-of-life configuration for this component.
end_of_life[x].material_typestring
The type of material this component is made from. Valid values are: "adhesive", "aluminum", "animal", "battery", "brass", "bronze", "cardboard", "ceramic", "chemical_non_organic", "chemical_non_organic_not_hazardous", "chemical_organic", "chemical_organic_not_hazardous", "concrete", "copper", "electronics", "glass", "hazardous", "metal_generic", "mixed_industrial", "mixed_municipal", "nickel", "oil_mineral", "oil_vegetable", "organic", "paint", "paper", "plant", "plastic", "plastic_abs", "plastic_hdpe", "plastic_ldpe", "plastic_pa", "plastic_pc", "plastic_pet", "plastic_pp", "plastic_ps", "plastic_pvc", "rubber", "solvent", "steel", "steel_stainless", "textile", "titanium", "wood", "zinc". When not specified, the system automatically classifies the material type based on the emission factor used for component production. If no classification is available, defaults to "mixed_industrial" with a warning notice. The system then selects appropriate emission factors for disposal treatment based on the material type.
waste_rationull or float
The percentage of this component lost during manufacture of the product. Must either be null or between 0 and 1 (inclusive). The percentage of this component lost during manufacture is not added to the product's weight. A corresponding amount of the component's end-of-life emissions is shifted from the product's end-of-life emissions and added to the product's production emissions instead.

Variations

A variations object allows specifying that one type of component is procured from several different sources, with different locations and potentially different attributes in terms of emissions. Each of these separate streams a component can come from is called a variation. Each variation is assigned a ratio to signify its share of the total procured for this component. All ratios summed up must amount to 1.0, signifying 100%.

A variations has the following attributes:

typerequired string
Value must be "variations"
variationsrequired array of at least 2 components that describe the variations.
variations[x].ratiorequired float
A number between 0 and 1, representing how large of a percentage of the final result comes from this variation. All 'ratio' objects inside a 'variations' object must add up to 1.
variations[x].componentrequired object
The component to be scaled. Can be either a Simple Component or a Product Reference.


curl --request POST \
  --url https://preview.api.climatiq.io/pcf/v1-preview2/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
	"product": "Electric desk lamp",
	"location": "Berlin",
	"manufacturing_year": 2025,
	"manufacturing": [
        {
            "type": "electricity",
            "amount": {
                "energy": 5,
                "energy_unit": "kWh"
            }
        }
    ],
    "use_phase": [
        {
          "type": "energy",
          "metadata": {"description": "typical lifetime usage (500 hours at 10W)"},
          "energy": {
            "amount": {
              "energy": 5.0,
              "energy_unit": "kWh"
            }
          }
        }
    ],
	"components": [
		{
			"type": "simple",
			"product": "aluminum base",
			"production_year": 2025,
			"weight": {
				"weight": 0.8,
				"weight_unit": "kg"
			},
			"location": "Munich"
		},
		{
			"type": "simple",
			"product": "plastic shade",
			"production_year": 2025,
			"weight": {
				"weight": 0.3,
				"weight_unit": "kg"
			},
			"location": "Shenzhen"
		},
		{
			"type": "simple",
			"product": "LED circuit board",
			"production_year": 2025,
			"weight": {
				"weight": 0.2,
				"weight_unit": "kg"
			},
			"location": "Taipei"
		}
	]
}'

Manufacturing

Each manufacturing object is classified by a type field, followed by parameters specific to this type.

Manufacturing electricity

A manufacturing electricity has the same fields as an electricity consumption object with these additional fields:

typerequired string
Value must be "electricity"
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.

For example:


{
    "type": "electricity",
    "amount": {
        "energy": 1.2,
        "energy_unit": "kWh"
    },
    "connection_type": "direct",
    "metadata": {
        "description": "Direct connection from our solar panels"
    }
}

Manufacturing electricity uses the market method for calculating emissions to ensure PACT compliance’.

Manufacturing heat & steam

A manufacturing heat & steam object has the following payload.

typerequired string
Value must be "heat_and_steam"
locationrequired object
The location of the manufacturing site or the usage site of the heat and/or steam. Accepts Location String, Query Location, IATA Code Location, UN/LOCODE Location or Coordinate Location.
yearinteger
Default value: Latest year available
The year for which the greenhouse gas emissions are being calculated.
Default Value
Latest year available
amountrequired Energy object
The total heat and steam purchased
co2e_kg_per_kwhfloat
Contract emission factor for the component in kg per kWh
energy_sourcestring
The source that the heat is generated from. Valid values are: renewable, coal, natural_gas, biomass or nuclear.
loss_factorfloat or string
Default value: medium
The distribution loss factor for this component. Can either be a number or one of the strings "low", "medium" or "high"
Default Value
medium

For details on heat & steam inputs, refer to the heat & steam endpoint of the energy API.

Manufacturing fuel use

A manufacturing fuel use object has some of the fields of the energy endpoint, but the region and year fields are omitted. The manufacturing location and year are automatically used instead.

typerequired string
Value must be "fuel"
fuel_typerequired string
The type of fuel burned. See choosing a fuel_type for how to choose this.
amountrequired Energy/Volume/Weight object
The amount of fuel burned.
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.

Manufacturing emission factor

This allows you to use a user-defined emission factor as a manufacturing emission. Note that technological representativeness in the data quality indicators will currently always be 5 (the worst value), since there is not enough data to gauge this characteristic.

typerequired string
Value must be "emission_factor"
emission_factorrequired A Selector
Use the fields of this selector to specify which emission factor to use for this emission.
parametersrequired object of type Parameter
The parameter to multiply the emission factor with. Must be of a compatibe unit with the emission factor.
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.

Use-phase emissions

Use-phase emissions are emitted after the product has been produced and shipped, and before its disposal. This can encompass things such as emissions emitted by installation and deinstallation processes or energy consumed during operation or stand-by. Each object has an optional name field that can be freely used for identifying and documenting the emission. The name will show up in the associated response item.

Energy

Represents a use-phase process consuming energy.

typerequired string
Value must be "energy"
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.
energyrequired Electricity consumption object
Electricity consumed in this process. Uses the market method for calculating emissions to ensure PACT compliance

Query

Uses Autopilot to find an appropriate emission factor for this emission.

typerequired string
Value must be "query"
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.
queryrequired string
The query string to feed into Autopilot to find an emission factor.
parametersrequired object of type Parameter
The parameter to multiply the emission factor with. Must be of a compatibe unit with the emission factor.

Emission Factor

Specify a selector to choose an emission factor for this emission.

typerequired string
Value must be "emission_factor"
metadataobject
A JSON object where you can put in string values containing custom metadata, for identification, correlation or documentation purposes.
emission_factorrequired A Selector
Use the fields of this selector to specify which emission factor to use for this emission.
parametersrequired object of type Parameter
The parameter to multiply the emission factor with. Must be of a compatibe unit with the emission factor.

Response

The response includes the estimated carbon footprint for the product along with detailed breakdowns.

Response parameters

product_idstring
The ID of the estimated product for later reference.
productstring
The name of the product as provided in the request.
cradle_to_gateobject
The total cradle-to-gate values for this product
cradle_to_gate.total_co2e_kgfloat
The total greenhouse gas emissions for the cradle-to-gate LCA of this product in kilograms CO2 equivalent.
cradle_to_gate.co2e_calculation_methodstring
The calculation methodology used for the cradle-to-gate calculation. The value of this is either "ipcc_ar4_gwp100", "ipcc_ar5_gwp100", "ipcc_ar6_gwp100" or "ipcc_mixed_gwp100". Learn more about calculation methods here.
cradle_to_gate.data_qualityData Quality object
An object containing both scaled and normalized data quality indicators for the cradle-to-gate calculations. See the Data Quality section for details.
locationstring
A string that describes the location where the good was produced, as provided in the request.
manufacturing_yearnumber
The year the product was manufactured as provided in the request.
weight_kgfloat
The weight of the returned product. Unless manually set, this will be the combined weight of all the components that go into this product, with the waste from those components subtracted.
manufacturingobject
Emissions from the manufacturing process.
manufacturing.total_co2e_kgfloat
Total emissions from manufacturing energy consumption in kg CO2e.
manufacturing.data_qualityData Quality object
Data quality indicators summed for all manufacturing emissions. See Data Quality for details.
manufacturing.breakdownarray of Manufacturing breakdown components
Breakdown of emissions from the manufacturing process.
noticesarray of Notice
An array of notices for this leg, that is relevant for understanding the result, and any limitations of it. Note that components in the components array might have their own notices as well.
end_of_lifeobject
End-of-life emissions calculation.
end_of_life[x].total_co2e_kgfloat
Total end-of-life emissions in kg CO2e.
end_of_life[x].allocation_methodstring
The allocation method used for end-of-life calculations.
end_of_life[x].breakdownarray of objects
Detailed breakdown of end-of-life emissions by material type. Each object represents emissions from disposing of a specific material type present in the product.
use_phaseobject or null
Breakdown of provided use-phase emissions. Only present if the request contained a use_phase section.
use_phase[x].total_co2e_kgfloat
Total use-phase emissions in kg CO2e.
use_phase[x].data_qualityData Quality object
An object containing both scaled and normalized data quality indicators for the cradle-to-gate calculations. See the Data Quality section for details.
use_phase[x].breakdownarray of use-phase response objects
Array of individual use-phase emissions. Each object corresponds to an input item in the request.
wastearray of objects
A breakdown of waste emitted during the manufacture of the product. The array will be sorted by CO2e in descending order. Note that material_type may be different from the input components, e.g. a wood input component may show up as organic waste here, analogous to the end_of_life field.
metadataobject or null
An object containing the custom metadata for the corresponding input item. If no metadata was provided, this is null.
componentsarray of objects
Array containing detailed information about each component used in the product. Each component object contains transportation information and component details.

Simple Component Response

When the component type is "simple", the component object contains:

Response parameters

typestring
Component type. Value is "simple".
productstring
The name of the component product.
metadataobject or null
An object containing the custom metadata for the corresponding input item. If no metadata was provided, this is null.
weight_kgfloat
The weight of the component.
locationstring or null
The location where the component was produced. This is null if no location was provided in the request.
productionEstimationWithSourceTrail plus additional fields
Production emissions and details for the component. This will contain an EstimationWithSourceTrail object plus the additional fields listed below.
production.calculation_detailsstring or null
An object with the field quality_label returned from autopilot. Possible values for the label are "accept" or "review". The quality_label can be null if autopilot was not used, such as when providing a custom selector.
production.data_qualityData Quality object
Data quality indicators for production emissions. See Data Quality for details.
wastenull or object
The waste emitted during the product's manufacture by this component. This is null unless the waste_ratio of the component was greater than 0. These objects are also aggregated on the response object's waste field.
noticesarray of Notice
An array of notices for this component, that is relevant for understanding the result, and any limitations of it.

Product Reference Response

When the component type is "reference", the component object contains the same values as the PCF response but with an additional type: "reference" field.

Freight Response

The transportation object contains emissions data from transporting components and has the following structure:

Response parameters

total_co2e_kgfloat
Total transportation emissions in kg CO2e.
routearray
The transportation route taken, represented as an array of alternating location and leg objects.
well_to_tank_co2efloat
Well-to-tank emissions for fuel used in transportation.
tank_to_wheel_co2efloat
Tank-to-wheel emissions from transportation.
logistics_hubs_co2efloat
Emissions from logistics hub operations.
multiplierWeight or Number
The multiplier that was specified when the reference to this product was made. If no multiplier was specified this will be null.
noticesarray of FreightNotice
An array of notices for the transportation part of this calculation, that is relevant for understanding the calculations, and any limitations of it.
data_qualityData Quality object
Data quality indicators for transportation emissions. See Data Quality for details.

Variations Response

When the component type is "variations", the component object contains:

Response parameters

typestring
Component type. Value is "variations".
variationsarray of objects describing the different variations
Array of the different variations with their ratios and components. The weight, production and transportation emissions (if any) of the component will be scaled according to the 'ratio' specified. Note that the referenced product itself will not be changed, only its use in this estimation will be scaled.
variations[x].ratiofloat
A number between 0 and 1, representing the percentage of the total component that comes from this variation.
variations[x].transportationFreight Response or null
Transportation emissions for transporting this variation component. Null if no transportation was required.
variations[x].componentobject
The component details for this variation. Can be either a Simple Component Response or a Product Reference Response.

Use phase response

These are the items in the breakdown array of the use_phase response object. Each use-phase item in the request yields an item of the corresponding type in this array.

Energy use-phase response

Represents emissions caused by energy consumption during the use-phase of the product.

Response parameters

typestring
Value is always "energy".
metadataobject or null
An object containing the custom metadata for the corresponding input item. If no metadata was provided, this is null.
total_co2e_kgfloat
Total emissions from use-phase energy consumption in kg CO2e.
generationfloat
Emissions from electricity generation in kg CO2e.
generation_wttfloat
Well-to-tank emissions for electricity generation in kg CO2e.
tndfloat
Transmission and distribution losses emissions in kg CO2e.
tnd_wttfloat
Well-to-tank emissions for transmission and distribution in kg CO2e.
electricity_used_kwhfloat
The amount of electricity used.
data_qualityData Quality object
Data quality indicators for electricity emissions. See Data Quality for details.
source_trailarray of Source Data Point
An array of Source Data Points that help explain and provide trust in the calculation. Click to view more details about Source Trail.
noticesarray of Notice
An array of notices concerning the electricity estimation for this item.

Query use-phase response

Represents query-based emissions produced during the use-phase of the product.

Response parameters

typestring
Value is always "query".
metadataobject or null
An object containing the custom metadata for the corresponding input item. If no metadata was provided, this is null.
estimateEstimation object
An estimation performed to achieve the final co2e value for this item.
noticesarray of Notice
An array of notices concerning the electricity estimation for this item.

Emission factor use-phase response

Represents emissions produced during the use-phase of the product when the emission factor to use was specified in the request.

The response is the same as query use-phase response.

Manufacturing breakdown components

This section describes the possible manufacturing breakdown types. All manufacturing breakdown types share the following fields.

Response parameters

typestring
Type discriminator. One of electricity, fuel, emission_factor, head_and_steam
total_co2e_kgnumber
The total CO2e in kg emitted from this item.
data_qualityData Quality object
Data quality indicators for manufacturing emissions. See Data Quality for details.
source_trailarray of Source Data Point
An array of Source Data Points that help explain and provide trust in the calculation. Click to view more details about Source Trail.
noticesarray of Notice
An array of notices concerning the estimation for this item.
metadataobject or null
An object containing the custom metadata for the corresponding input item. If no metadata was provided, this is null.
detailsobject
This contains details on the estimation. If the estimation is for electricity or head_and_steam, this field is of type Manufacturing electricity, heat and steam. If this estimation is for type emission_factor, this field is of type Manufacturing emission factor. For type fuel, no details are given and this field is always an empty object.

Manufacturing electricity, heat and steam

The following fields are part of a manufacturing electricity, heat & steam breakdown component.

Response parameters

generationfloat
Emissions from energy generation in kg CO2e.
generation_wttfloat
Well-to-tank emissions for energy generation in kg CO2e.
tndfloat
Transmission and distribution losses emissions in kg CO2e.
tnd_wttfloat
Well-to-tank emissions for transmission and distribution in kg CO2e.

Manufacturing emission factor

A manufacturing emission factor breakdown component contains in its details field all fields of an estimation object.

Get previous estimation

GET This endpoint allows you to retrieve the results of a previous estimation using the ID returned with the original estimation.

Request


https://api.climatiq.io/pcf/v1-preview2/{id}

The id part is the ID returned in the previous estimation.

The response is equivalent to the one from the estimation endpoint.

Data Quality

The Data Quality object provides an indication of the reliability of the carbon footprint estimation. It contains both scaled and normalized data quality indicators, as defined by the PACT standard.

Response parameters

scaledobject
Scaled data quality indicators. Higher values indicate where improving data quality would most reduce uncertainty in your footprint. These are calculated by multiplying each indicator rating by the CO2e contribution of that component. If the co2e is 0 for the given estimation, these values will all be 0.
scaled.technological_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual technology / technologies used in the process.
scaled.geographical_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual geographic location of the processes.
scaled.temporal_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual time (e.g., year) or age of the process.
normalizedobject
Normalized data quality indicators with values between 1 and 5, where 1 is best and 5 is worst. These represent the overall data quality rating for your product, calculated by dividing the summed scaled indicators by the total CO2e. If the co2e is 0 for the given estimation, these numbers will default to 5.
normalized.technological_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual technology / technologies used in the process.
normalized.geographical_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual geographic location of the processes.
normalized.temporal_representativeness_data_quality_ratingfloat
A data quality rating for the degree to which the data reflects the actual time (e.g., year) or age of the process.

Each time something is estimated when performing a PCF, these three indicators are evaluated, and each is given a data quality rating between 1 and 5, where 1 is the best, and 5 is the worst.

To identify which components have the biggest impact on your footprint’s uncertainty, these ratings are scaled by multiplying them by each component’s CO2e contribution. This creates the scaled indicators - larger values indicate where improving data quality would improve data quality the most.

These scaled values are summed up through the calculation tree. The normalized indicators show the overall data quality rating for each indicator (back in the 1-5 range), calculated by dividing the summed scaled indicators by the CO2e at each level.

As the PCF feature uses secondary data, often the expected data quality indicator will be between 2 and 4. For more information see the PACT standard

Notice

The notices array for non-transportation can contain these objects:

Notice attributes
severity string Either `warning` or `info`. `warning` is for messages that might lead to inaccurate calculations. You should check these to make sure the results are fit for your intended purpose. `info` is for information that will help you understand the calculation result better.
message string An explanation of the notice.
code string A programmatic value you can use to disambiguate the different notice types.

The different possible values for code are as follows. You should not treat this list as exhaustive as more values may be added with time:

Any code from autopilot.
Any code from electricity
Any code from freight

And these additional codes:

Notice code value	description
`material_type_fallback`	The material type for a component was automatically set to a generic default (`mixed_industrial`) because no mapping exists for the emission factor used. For more accurate end-of-life emissions, consider specifying the material type explicitly.
`no_location_specified`	No location was specified for a simple component. Freight emissions will not be calculated, and emission factor selection will not filter by region.

Limitations

This endpoint provides an estimate of a product’s carbon footprint. These estimates may have significant uncertainties, and users should validate the output values.

The current limitations of the endpoint are:

Emissions from industrial heating and cooling processes are not yet supported.
Direct emissions from chemical reactions (e.g., in cement production) are not supported.
Different selected emission factors for the components may have variations in LCA boundaries.
Currently, if a component is in the same location as where it is needed, some transportation emissions will still be emitted, due to logistics hubs handling. It is to be determined whether this is correct or not.

FAQ

How do I handle packaging?

When shipping the component that comes into your final product, some packaging is involved, that is discarded. While this packaging contributes to the final emissions of the product, it does not contribute to the final weight. This packaging should be included in the PCF.

To handle packaging for your input components we recommend that you:

Add the packaging as a separate input component, with the same location as the component it is being used to package.
Set the waste_ratio to 1.0 for the component. This means that all of the component will be considered as waste during the manufacturing process, and it will not add to the final weight of your PCF.

See the below example for how to specify 200 grams of cardboard packaging.


{
    "product": "LED Assembly",
    "location": {
        "query": "berlin"
    },
    "manufacturing_year": 2025,
    "manufacturing": [
        {
            "type": "electricity",
            "amount": {
                "energy": 3,
                "energy_unit": "kWh"
            }
        }
    ],
    "components": [
        // The actual component you are using
        {
            "type": "simple",
            "product": "LED chip",
            "production_year": 2025,
            "weight": {
                "weight": 0.15,
                "weight_unit": "kg"
            },
            "location": {
                "query": "Taipei"
            }
        },
        // Packaging for the above component
        {
            "type": "simple",
            "product": "cardboard",
            "production_year": 2025,
            "weight": {
                "weight": 0.2,
                "weight_unit": "kg"
            },
            "location": {
                "query": "Taipei"
            },
            "waste_ratio": 1.0
        }
    ]
}

Additional examples

This section contains a few additional examples of requests and responses to show you how to compose requests.

Creating a reusable component with variations

This example creates an LED assembly product that sources LED chips from two different locations (70% from Taipei, 30% from Seoul) using the variations component type:


curl --request POST \
  --url https://preview.api.climatiq.io/pcf/v1-preview2/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
	"product": "LED Assembly",
	"location": {
		"query": "berlin"
	},
	"manufacturing_year": 2025,
	"manufacturing": [
    {
      "type": "electricity",
      "amount": {
        "energy": 3,
        "energy_unit": "kWh"
      }
    }
  ],
	"components": [
		{
			"type": "variations",
			"variations": [
				{
					"ratio": 0.7,
					"component": {
						"type": "simple",
						"product": "LED chip",
						"metadata": {"product_description": "LED Chip from Taipei"},
						"production_year": 2025,
						"weight": {
							"weight": 0.15,
							"weight_unit": "kg"
						},
						"location": {
							"query": "Taipei"
						}
					}
				},
				{
					"ratio": 0.3,
					"component": {
						"type": "simple",
						"product": "LED chip",
						"metadata": {"product_description": "LED Chip from Seoul"},
						"production_year": 2025,
						"weight": {
							"weight": 0.15,
							"weight_unit": "kg"
						},
						"location": {
							"query": "Seoul"
						}
					}
				}
			]
		}
	]
}'

The response includes a product_id that can be referenced in other product calculations:


{
    "product_id": "66ee707a-cbd6-4750-95de-34e13f830ea0",
    "product": "LED Assembly",
    "metadata": null,
    "cradle_to_gate": {
        "total_co2e_kg": 2.67204881264,
        "co2e_calculation_method": "ipcc_mixed_gwp100",
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 6.33036570106,
                "geographical_representativeness_data_quality_rating": 5.55663780117,
                "temporal_representativeness_data_quality_rating": 5.26610864976
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 2.36910556092,
                "geographical_representativeness_data_quality_rating": 2.07954202591,
                "temporal_representativeness_data_quality_rating": 1.97081304236
            }
        }
    },
    "location": "Berlin, Germany",
    "manufacturing_year": 2025,
    "weight_kg": 0.15,
    "multiplier": null,
    "manufacturing": {
        "total_co2e_kg": 2.59405983712,
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 5.9404208235,
                "geographical_representativeness_data_quality_rating": 5.18811967425,
                "temporal_representativeness_data_quality_rating": 5.18811967425
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 2.29000917345,
                "geographical_representativeness_data_quality_rating": 2,
                "temporal_representativeness_data_quality_rating": 2
            }
        },
        "breakdown": [
            {
                "type": "electricity",
                "total_co2e_kg": 2.59405983712,
                "metadata": null,
                "details": {
                    "generation": 2.1597092625,
                    "generation_wtt": 0.367150574625,
                    "tnd": 0.0582,
                    "tnd_wtt": 0.009
                },
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 5.9404208235,
                        "geographical_representativeness_data_quality_rating": 5.18811967425,
                        "temporal_representativeness_data_quality_rating": 5.18811967425
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 2.29000917345,
                        "geographical_representativeness_data_quality_rating": 2,
                        "temporal_representativeness_data_quality_rating": 2
                    }
                },
                "notices": [
                    {
                        "severity": "warning",
                        "code": "global_default_wtt_used",
                        "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
                    }
                ],
                "source_trail": [
                    {
                        "data_category": null,
                        "name": "Default well-to-tank ratio of electricity generation emissions",
                        "source": "Climatiq",
                        "source_dataset": null,
                        "year": null,
                        "region": "GLOBAL",
                        "region_name": "Global",
                        "id": null
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "c8c06d6b-9457-4e84-9256-0717cc604013"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "da2cd1a5-44b5-404c-b285-9f418c4d0f4c"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid - residual mix",
                        "source": "AIB",
                        "source_dataset": "European Residual Mix",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "1d3c57a2-9b8b-4426-b4e4-4ac2c90eff34"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid: T&D losses",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "a30a504d-e24c-4d1c-b4df-7d61816fa183"
                    }
                ]
            }
        ]
    },
    "notices": [
        {
            "severity": "warning",
            "code": "global_default_wtt_used",
            "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
        }
    ],
    "end_of_life": {
        "total_co2e_kg": 0.0009615915,
        "allocation_method": "cut_off",
        "breakdown": [
            {
                "total_co2e_kg": 0.0009615915,
                "material_type": "wood",
                "total_weight_kg": 0.15,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Wood waste disposal (combustion)",
                        "source": "BEIS",
                        "source_dataset": "Greenhouse gas reporting: conversion factors 2024",
                        "year": "2024",
                        "region": "GB",
                        "region_name": "United Kingdom",
                        "id": "d1cedaa2-87bb-4525-954b-1a7f6fe94b9b"
                    }
                ]
            }
        ]
    },
    "use_phase": null,
    "waste": [],
    "components": [
        {
            "transportation": null,
            "component": {
                "type": "variations",
                "variations": [
                    {
                        "ratio": 0.7,
                        "transportation": {
                            "total_co2e_kg": 0.012301051452,
                            "route": [
                                {
                                    "type": "location",
                                    "location": "Taipei City, 110, Taiwan"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "road",
                                    "distance_km": 26.479
                                },
                                {
                                    "type": "location",
                                    "location": "Sea Port at CHI-LUNG"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "sea",
                                    "distance_km": 20480.059695
                                },
                                {
                                    "type": "location",
                                    "location": "Sea Port at SZCZECIN"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "road",
                                    "distance_km": 144.236
                                },
                                {
                                    "type": "location",
                                    "location": "Berlin, Germany"
                                }
                            ],
                            "well_to_tank_co2e": 0.00197833765664,
                            "tank_to_wheel_co2e": 0.00982501379541,
                            "logistics_hubs_co2e": 0.0004977,
                            "notices": [],
                            "data_quality": {
                                "scaled": {
                                    "technological_representativeness_data_quality_rating": 0.0615052572602,
                                    "geographical_representativeness_data_quality_rating": 0.0469056500606,
                                    "temporal_representativeness_data_quality_rating": 0.012301051452
                                },
                                "normalized": {
                                    "technological_representativeness_data_quality_rating": 5,
                                    "geographical_representativeness_data_quality_rating": 3.81314152237,
                                    "temporal_representativeness_data_quality_rating": 1
                                }
                            }
                        },
                        "component": {
                            "type": "simple",
                            "product": "LED chip",
                            "metadata": {
                                "product_description": "LED Chip from Taipei"
                            },
                            "weight_kg": 0.105,
                            "location": "Taipei City, 110, Taiwan",
                            "production": {
                                "estimate": {
                                    "co2e": 0.042,
                                    "co2e_unit": "kg",
                                    "co2e_calculation_method": "ar4",
                                    "co2e_calculation_origin": "source",
                                    "emission_factor": {
                                        "name": "Chipboard",
                                        "activity_id": "timber_forestry-type_chipboard",
                                        "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e",
                                        "access_type": "public",
                                        "source": "Bafa",
                                        "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                        "year": 2025,
                                        "region": "DE",
                                        "category": "Timber and Forestry Products",
                                        "source_lca_activity": "cradle_to_gate",
                                        "data_quality_flags": [
                                            "notable_methodological_variance"
                                        ]
                                    },
                                    "constituent_gases": {
                                        "co2e_total": 0.042,
                                        "co2e_other": null,
                                        "co2": null,
                                        "ch4": null,
                                        "n2o": null
                                    },
                                    "activity_data": {
                                        "activity_value": 0.105,
                                        "activity_unit": "kg"
                                    },
                                    "audit_trail": "enabled"
                                },
                                "data_quality": {
                                    "scaled": {
                                        "technological_representativeness_data_quality_rating": 0.21,
                                        "geographical_representativeness_data_quality_rating": 0.21,
                                        "temporal_representativeness_data_quality_rating": 0.042
                                    },
                                    "normalized": {
                                        "technological_representativeness_data_quality_rating": 5,
                                        "geographical_representativeness_data_quality_rating": 5,
                                        "temporal_representativeness_data_quality_rating": 1
                                    }
                                },
                                "calculation_details": {
                                    "quality_label": "review"
                                },
                                "source_trail": [
                                    {
                                        "data_category": "emission_factor",
                                        "name": "Chipboard",
                                        "source": "Bafa",
                                        "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                        "year": "2025",
                                        "region": "DE",
                                        "region_name": "Germany",
                                        "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e"
                                    }
                                ]
                            },
                            "notices": [
                                {
                                    "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region TW.",
                                    "code": "emission_factor_region_fallback",
                                    "severity": "warning"
                                }
                            ],
                            "waste": null
                        }
                    },
                    {
                        "ratio": 0.3,
                        "transportation": {
                            "total_co2e_kg": 0.0056879240598,
                            "route": [
                                {
                                    "type": "location",
                                    "location": "Seoul, South Korea, South Korea"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "road",
                                    "distance_km": 49.119
                                },
                                {
                                    "type": "location",
                                    "location": "Sea Port at INCHON"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "sea",
                                    "distance_km": 21796.906362
                                },
                                {
                                    "type": "location",
                                    "location": "Sea Port at SZCZECIN"
                                },
                                {
                                    "type": "leg",
                                    "transport_mode": "road",
                                    "distance_km": 144.236
                                },
                                {
                                    "type": "location",
                                    "location": "Berlin, Germany"
                                }
                            ],
                            "well_to_tank_co2e": 0.000923607066714,
                            "tank_to_wheel_co2e": 0.00455101699309,
                            "logistics_hubs_co2e": 0.0002133,
                            "notices": [],
                            "data_quality": {
                                "scaled": {
                                    "technological_representativeness_data_quality_rating": 0.028439620299,
                                    "geographical_representativeness_data_quality_rating": 0.0216124768548,
                                    "temporal_representativeness_data_quality_rating": 0.0056879240598
                                },
                                "normalized": {
                                    "technological_representativeness_data_quality_rating": 5,
                                    "geographical_representativeness_data_quality_rating": 3.79971262407,
                                    "temporal_representativeness_data_quality_rating": 1
                                }
                            }
                        },
                        "component": {
                            "type": "simple",
                            "product": "LED chip",
                            "metadata": {
                                "product_description": "LED Chip from Seoul"
                            },
                            "weight_kg": 0.045,
                            "location": "Seoul, South Korea, South Korea",
                            "production": {
                                "estimate": {
                                    "co2e": 0.018,
                                    "co2e_unit": "kg",
                                    "co2e_calculation_method": "ar4",
                                    "co2e_calculation_origin": "source",
                                    "emission_factor": {
                                        "name": "Chipboard",
                                        "activity_id": "timber_forestry-type_chipboard",
                                        "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e",
                                        "access_type": "public",
                                        "source": "Bafa",
                                        "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                        "year": 2025,
                                        "region": "DE",
                                        "category": "Timber and Forestry Products",
                                        "source_lca_activity": "cradle_to_gate",
                                        "data_quality_flags": [
                                            "notable_methodological_variance"
                                        ]
                                    },
                                    "constituent_gases": {
                                        "co2e_total": 0.018,
                                        "co2e_other": null,
                                        "co2": null,
                                        "ch4": null,
                                        "n2o": null
                                    },
                                    "activity_data": {
                                        "activity_value": 0.045,
                                        "activity_unit": "kg"
                                    },
                                    "audit_trail": "enabled"
                                },
                                "data_quality": {
                                    "scaled": {
                                        "technological_representativeness_data_quality_rating": 0.09,
                                        "geographical_representativeness_data_quality_rating": 0.09,
                                        "temporal_representativeness_data_quality_rating": 0.018
                                    },
                                    "normalized": {
                                        "technological_representativeness_data_quality_rating": 5,
                                        "geographical_representativeness_data_quality_rating": 5,
                                        "temporal_representativeness_data_quality_rating": 1
                                    }
                                },
                                "calculation_details": {
                                    "quality_label": "review"
                                },
                                "source_trail": [
                                    {
                                        "data_category": "emission_factor",
                                        "name": "Chipboard",
                                        "source": "Bafa",
                                        "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                        "year": "2025",
                                        "region": "DE",
                                        "region_name": "Germany",
                                        "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e"
                                    }
                                ]
                            },
                            "notices": [
                                {
                                    "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region KR.",
                                    "code": "emission_factor_region_fallback",
                                    "severity": "warning"
                                }
                            ],
                            "waste": null
                        }
                    }
                ]
            }
        }
    ]
}

Composing products with references

This example creates a desk lamp that references the LED assembly created above. By using type: "reference" with the product_id from the previous calculation, you can compose complex products from previously calculated PCFs:


curl --request POST \
  --url https://preview.api.climatiq.io/pcf/v1-preview2/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
	"product": "Electric desk lamp",
	"location": {
		"query": "berlin"
	},
	"manufacturing_year": 2025,
	"manufacturing": [
    {
      "type": "electricity",
      "amount": {
        "energy": 2,
        "energy_unit": "kWh"
      }
    }
  ],
	"components": [
		{
			"type": "reference",
			"id": "66ee707a-cbd6-4750-95de-34e13f830ea0",
			"transportation_mode": "sea"
		},
		{
			"type": "simple",
			"product": "aluminum base",
			"production_year": 2025,
			"weight": {
				"weight": 0.8,
				"weight_unit": "kg"
			},
			"location": {
				"query": "Munich"
			}
		},
		{
			"type": "simple",
			"product": "plastic shade",
			"production_year": 2025,
			"weight": {
				"weight": 0.3,
				"weight_unit": "kg"
			},
			"location": {
				"query": "Shenzhen"
			}
		}
	]
}'

The response includes the full cradle-to-gate emissions for the composed product, including the emissions from the referenced LED assembly:


{
    "product_id": "fb8184c4-6fe8-4686-965a-1afa66affa77",
    "product": "Electric desk lamp",
    "metadata": null,
    "cradle_to_gate": {
        "total_co2e_kg": 12.2602459983,
        "co2e_calculation_method": "ipcc_mixed_gwp100",
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 49.5847660548,
                "geographical_representativeness_data_quality_rating": 48.1508388165,
                "temporal_representativeness_data_quality_rating": 16.5836790602
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 4.04435327493,
                "geographical_representativeness_data_quality_rating": 3.92739581433,
                "temporal_representativeness_data_quality_rating": 1.35263836162
            }
        }
    },
    "location": "Berlin, Germany",
    "manufacturing_year": 2025,
    "weight_kg": 1.25,
    "multiplier": null,
    "manufacturing": {
        "total_co2e_kg": 1.72937322475,
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 3.960280549,
                "geographical_representativeness_data_quality_rating": 3.4587464495,
                "temporal_representativeness_data_quality_rating": 3.4587464495
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 2.29000917345,
                "geographical_representativeness_data_quality_rating": 2,
                "temporal_representativeness_data_quality_rating": 2
            }
        },
        "breakdown": [
            {
                "type": "electricity",
                "total_co2e_kg": 1.72937322475,
                "metadata": null,
                "details": {
                    "generation": 1.439806175,
                    "generation_wtt": 0.24476704975,
                    "tnd": 0.0388,
                    "tnd_wtt": 0.006
                },
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 3.960280549,
                        "geographical_representativeness_data_quality_rating": 3.4587464495,
                        "temporal_representativeness_data_quality_rating": 3.4587464495
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 2.29000917345,
                        "geographical_representativeness_data_quality_rating": 2,
                        "temporal_representativeness_data_quality_rating": 2
                    }
                },
                "notices": [
                    {
                        "severity": "warning",
                        "code": "global_default_wtt_used",
                        "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
                    }
                ],
                "source_trail": [
                    {
                        "data_category": null,
                        "name": "Default well-to-tank ratio of electricity generation emissions",
                        "source": "Climatiq",
                        "source_dataset": null,
                        "year": null,
                        "region": "GLOBAL",
                        "region_name": "Global",
                        "id": null
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "c8c06d6b-9457-4e84-9256-0717cc604013"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "da2cd1a5-44b5-404c-b285-9f418c4d0f4c"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid - residual mix",
                        "source": "AIB",
                        "source_dataset": "European Residual Mix",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "1d3c57a2-9b8b-4426-b4e4-4ac2c90eff34"
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid: T&D losses",
                        "source": "UBA",
                        "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                        "year": "2023",
                        "region": "DE",
                        "region_name": "Germany",
                        "id": "a30a504d-e24c-4d1c-b4df-7d61816fa183"
                    }
                ]
            }
        ]
    },
    "notices": [
        {
            "severity": "warning",
            "code": "global_default_wtt_used",
            "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
        }
    ],
    "end_of_life": {
        "total_co2e_kg": 0.0212935054748,
        "allocation_method": "cut_off",
        "breakdown": [
            {
                "total_co2e_kg": 0.0176369809748,
                "material_type": "aluminum",
                "total_weight_kg": 0.8,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Aluminum Ingot - Landfilled",
                        "source": "EPA",
                        "source_dataset": "2025 GHG Emission Factors Hub",
                        "year": "2025",
                        "region": "US",
                        "region_name": "United States of America (the)",
                        "id": "24616429-727c-428e-858d-993bb70b3355"
                    }
                ]
            },
            {
                "total_co2e_kg": 0.002694933,
                "material_type": "plastic",
                "total_weight_kg": 0.3,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Plastics waste disposal (landfill)",
                        "source": "BEIS",
                        "source_dataset": "Greenhouse gas reporting: conversion factors 2025",
                        "year": "2025",
                        "region": "GB",
                        "region_name": "United Kingdom",
                        "id": "57541e5f-14e6-4626-a1db-67c7b5856ee7"
                    }
                ]
            },
            {
                "total_co2e_kg": 0.0009615915,
                "material_type": "wood",
                "total_weight_kg": 0.15,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Wood waste disposal (combustion)",
                        "source": "BEIS",
                        "source_dataset": "Greenhouse gas reporting: conversion factors 2024",
                        "year": "2024",
                        "region": "GB",
                        "region_name": "United Kingdom",
                        "id": "d1cedaa2-87bb-4525-954b-1a7f6fe94b9b"
                    }
                ]
            }
        ]
    },
    "use_phase": null,
    "waste": [],
    "components": [
        {
            "transportation": null,
            "component": {
                "type": "reference",
                "product_id": "66ee707a-cbd6-4750-95de-34e13f830ea0",
                "product": "LED Assembly",
                "metadata": null,
                "cradle_to_gate": {
                    "total_co2e_kg": 2.67204881264,
                    "co2e_calculation_method": "ipcc_mixed_gwp100",
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 6.33036570106,
                            "geographical_representativeness_data_quality_rating": 5.55663780117,
                            "temporal_representativeness_data_quality_rating": 5.26610864976
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 2.36910556092,
                            "geographical_representativeness_data_quality_rating": 2.07954202591,
                            "temporal_representativeness_data_quality_rating": 1.97081304236
                        }
                    }
                },
                "location": "Berlin, Germany",
                "manufacturing_year": 2025,
                "weight_kg": 0.15,
                "multiplier": null,
                "manufacturing": {
                    "total_co2e_kg": 2.59405983712,
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 5.9404208235,
                            "geographical_representativeness_data_quality_rating": 5.18811967425,
                            "temporal_representativeness_data_quality_rating": 5.18811967425
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 2.29000917345,
                            "geographical_representativeness_data_quality_rating": 2,
                            "temporal_representativeness_data_quality_rating": 2
                        }
                    },
                    "breakdown": [
                        {
                            "type": "electricity",
                            "total_co2e_kg": 2.59405983712,
                            "metadata": null,
                            "details": {
                                "generation": 2.1597092625,
                                "generation_wtt": 0.367150574625,
                                "tnd": 0.0582,
                                "tnd_wtt": 0.009
                            },
                            "data_quality": {
                                "scaled": {
                                    "technological_representativeness_data_quality_rating": 5.9404208235,
                                    "geographical_representativeness_data_quality_rating": 5.18811967425,
                                    "temporal_representativeness_data_quality_rating": 5.18811967425
                                },
                                "normalized": {
                                    "technological_representativeness_data_quality_rating": 2.29000917345,
                                    "geographical_representativeness_data_quality_rating": 2,
                                    "temporal_representativeness_data_quality_rating": 2
                                }
                            },
                            "notices": [
                                {
                                    "severity": "warning",
                                    "code": "global_default_wtt_used",
                                    "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
                                }
                            ],
                            "source_trail": [
                                {
                                    "data_category": null,
                                    "name": "Default well-to-tank ratio of electricity generation emissions",
                                    "source": "Climatiq",
                                    "source_dataset": null,
                                    "year": null,
                                    "region": "GLOBAL",
                                    "region_name": "Global",
                                    "id": null
                                },
                                {
                                    "data_category": "emission_factor",
                                    "name": "Electricity supplied from grid",
                                    "source": "UBA",
                                    "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                                    "year": "2023",
                                    "region": "DE",
                                    "region_name": "Germany",
                                    "id": "c8c06d6b-9457-4e84-9256-0717cc604013"
                                },
                                {
                                    "data_category": "emission_factor",
                                    "name": "Electricity supplied from grid",
                                    "source": "UBA",
                                    "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                                    "year": "2023",
                                    "region": "DE",
                                    "region_name": "Germany",
                                    "id": "da2cd1a5-44b5-404c-b285-9f418c4d0f4c"
                                },
                                {
                                    "data_category": "emission_factor",
                                    "name": "Electricity supplied from grid - residual mix",
                                    "source": "AIB",
                                    "source_dataset": "European Residual Mix",
                                    "year": "2023",
                                    "region": "DE",
                                    "region_name": "Germany",
                                    "id": "1d3c57a2-9b8b-4426-b4e4-4ac2c90eff34"
                                },
                                {
                                    "data_category": "emission_factor",
                                    "name": "Electricity supplied from grid: T&D losses",
                                    "source": "UBA",
                                    "source_dataset": "Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2023",
                                    "year": "2023",
                                    "region": "DE",
                                    "region_name": "Germany",
                                    "id": "a30a504d-e24c-4d1c-b4df-7d61816fa183"
                                }
                            ]
                        }
                    ]
                },
                "notices": [
                    {
                        "severity": "warning",
                        "code": "global_default_wtt_used",
                        "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
                    }
                ],
                "end_of_life": null,
                "use_phase": null,
                "waste": [],
                "components": [
                    {
                        "transportation": null,
                        "component": {
                            "type": "variations",
                            "variations": [
                                {
                                    "ratio": 0.7,
                                    "transportation": {
                                        "total_co2e_kg": 0.012301051452,
                                        "route": [
                                            {
                                                "type": "location",
                                                "location": "Taipei City, 110, Taiwan"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "road",
                                                "distance_km": 26.479
                                            },
                                            {
                                                "type": "location",
                                                "location": "Sea Port at CHI-LUNG"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "sea",
                                                "distance_km": 20480.059695
                                            },
                                            {
                                                "type": "location",
                                                "location": "Sea Port at SZCZECIN"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "road",
                                                "distance_km": 144.236
                                            },
                                            {
                                                "type": "location",
                                                "location": "Berlin, Germany"
                                            }
                                        ],
                                        "well_to_tank_co2e": 0.00197833765664,
                                        "tank_to_wheel_co2e": 0.00982501379541,
                                        "logistics_hubs_co2e": 0.0004977,
                                        "notices": [],
                                        "data_quality": {
                                            "scaled": {
                                                "technological_representativeness_data_quality_rating": 0.0615052572602,
                                                "geographical_representativeness_data_quality_rating": 0.0469056500606,
                                                "temporal_representativeness_data_quality_rating": 0.012301051452
                                            },
                                            "normalized": {
                                                "technological_representativeness_data_quality_rating": 5,
                                                "geographical_representativeness_data_quality_rating": 3.81314152237,
                                                "temporal_representativeness_data_quality_rating": 1
                                            }
                                        }
                                    },
                                    "component": {
                                        "type": "simple",
                                        "product": "LED chip",
                                        "metadata": {
                                            "product_description": "LED Chip from Taipei"
                                        },
                                        "weight_kg": 0.105,
                                        "location": "Taipei City, 110, Taiwan",
                                        "production": {
                                            "estimate": {
                                                "co2e": 0.042,
                                                "co2e_unit": "kg",
                                                "co2e_calculation_method": "ar4",
                                                "co2e_calculation_origin": "source",
                                                "emission_factor": {
                                                    "name": "Chipboard",
                                                    "activity_id": "timber_forestry-type_chipboard",
                                                    "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e",
                                                    "access_type": "public",
                                                    "source": "Bafa",
                                                    "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                                    "year": 2025,
                                                    "region": "DE",
                                                    "category": "Timber and Forestry Products",
                                                    "source_lca_activity": "cradle_to_gate",
                                                    "data_quality_flags": [
                                                        "notable_methodological_variance"
                                                    ]
                                                },
                                                "constituent_gases": {
                                                    "co2e_total": 0.042,
                                                    "co2e_other": null,
                                                    "co2": null,
                                                    "ch4": null,
                                                    "n2o": null
                                                },
                                                "activity_data": {
                                                    "activity_value": 0.105,
                                                    "activity_unit": "kg"
                                                },
                                                "audit_trail": "enabled"
                                            },
                                            "data_quality": {
                                                "scaled": {
                                                    "technological_representativeness_data_quality_rating": 0.21,
                                                    "geographical_representativeness_data_quality_rating": 0.21,
                                                    "temporal_representativeness_data_quality_rating": 0.042
                                                },
                                                "normalized": {
                                                    "technological_representativeness_data_quality_rating": 5,
                                                    "geographical_representativeness_data_quality_rating": 5,
                                                    "temporal_representativeness_data_quality_rating": 1
                                                }
                                            },
                                            "calculation_details": {
                                                "quality_label": "review"
                                            },
                                            "source_trail": [
                                                {
                                                    "data_category": "emission_factor",
                                                    "name": "Chipboard",
                                                    "source": "Bafa",
                                                    "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                                    "year": "2025",
                                                    "region": "DE",
                                                    "region_name": "Germany",
                                                    "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e"
                                                }
                                            ]
                                        },
                                        "notices": [
                                            {
                                                "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region TW.",
                                                "code": "emission_factor_region_fallback",
                                                "severity": "warning"
                                            }
                                        ],
                                        "waste": null
                                    }
                                },
                                {
                                    "ratio": 0.3,
                                    "transportation": {
                                        "total_co2e_kg": 0.0056879240598,
                                        "route": [
                                            {
                                                "type": "location",
                                                "location": "Seoul, South Korea, South Korea"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "road",
                                                "distance_km": 49.119
                                            },
                                            {
                                                "type": "location",
                                                "location": "Sea Port at INCHON"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "sea",
                                                "distance_km": 21796.906362
                                            },
                                            {
                                                "type": "location",
                                                "location": "Sea Port at SZCZECIN"
                                            },
                                            {
                                                "type": "leg",
                                                "transport_mode": "road",
                                                "distance_km": 144.236
                                            },
                                            {
                                                "type": "location",
                                                "location": "Berlin, Germany"
                                            }
                                        ],
                                        "well_to_tank_co2e": 0.000923607066714,
                                        "tank_to_wheel_co2e": 0.00455101699309,
                                        "logistics_hubs_co2e": 0.0002133,
                                        "notices": [],
                                        "data_quality": {
                                            "scaled": {
                                                "technological_representativeness_data_quality_rating": 0.028439620299,
                                                "geographical_representativeness_data_quality_rating": 0.0216124768548,
                                                "temporal_representativeness_data_quality_rating": 0.0056879240598
                                            },
                                            "normalized": {
                                                "technological_representativeness_data_quality_rating": 5,
                                                "geographical_representativeness_data_quality_rating": 3.79971262407,
                                                "temporal_representativeness_data_quality_rating": 1
                                            }
                                        }
                                    },
                                    "component": {
                                        "type": "simple",
                                        "product": "LED chip",
                                        "metadata": {
                                            "product_description": "LED Chip from Seoul"
                                        },
                                        "weight_kg": 0.045,
                                        "location": "Seoul, South Korea, South Korea",
                                        "production": {
                                            "estimate": {
                                                "co2e": 0.018,
                                                "co2e_unit": "kg",
                                                "co2e_calculation_method": "ar4",
                                                "co2e_calculation_origin": "source",
                                                "emission_factor": {
                                                    "name": "Chipboard",
                                                    "activity_id": "timber_forestry-type_chipboard",
                                                    "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e",
                                                    "access_type": "public",
                                                    "source": "Bafa",
                                                    "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                                    "year": 2025,
                                                    "region": "DE",
                                                    "category": "Timber and Forestry Products",
                                                    "source_lca_activity": "cradle_to_gate",
                                                    "data_quality_flags": [
                                                        "notable_methodological_variance"
                                                    ]
                                                },
                                                "constituent_gases": {
                                                    "co2e_total": 0.018,
                                                    "co2e_other": null,
                                                    "co2": null,
                                                    "ch4": null,
                                                    "n2o": null
                                                },
                                                "activity_data": {
                                                    "activity_value": 0.045,
                                                    "activity_unit": "kg"
                                                },
                                                "audit_trail": "enabled"
                                            },
                                            "data_quality": {
                                                "scaled": {
                                                    "technological_representativeness_data_quality_rating": 0.09,
                                                    "geographical_representativeness_data_quality_rating": 0.09,
                                                    "temporal_representativeness_data_quality_rating": 0.018
                                                },
                                                "normalized": {
                                                    "technological_representativeness_data_quality_rating": 5,
                                                    "geographical_representativeness_data_quality_rating": 5,
                                                    "temporal_representativeness_data_quality_rating": 1
                                                }
                                            },
                                            "calculation_details": {
                                                "quality_label": "review"
                                            },
                                            "source_trail": [
                                                {
                                                    "data_category": "emission_factor",
                                                    "name": "Chipboard",
                                                    "source": "Bafa",
                                                    "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                                                    "year": "2025",
                                                    "region": "DE",
                                                    "region_name": "Germany",
                                                    "id": "2f53adb7-a2ff-444a-9e29-f319a09c828e"
                                                }
                                            ]
                                        },
                                        "notices": [
                                            {
                                                "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region KR.",
                                                "code": "emission_factor_region_fallback",
                                                "severity": "warning"
                                            }
                                        ],
                                        "waste": null
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        },
        {
            "transportation": {
                "total_co2e_kg": 0.0599169728,
                "route": [
                    {
                        "type": "location",
                        "location": "Munich, Bavaria, Germany"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 583.034
                    },
                    {
                        "type": "location",
                        "location": "Berlin, Germany"
                    }
                ],
                "well_to_tank_co2e": 0.0135263888,
                "tank_to_wheel_co2e": 0.044310584,
                "logistics_hubs_co2e": 0.00208,
                "notices": [],
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 0.299584864,
                        "geographical_representativeness_data_quality_rating": 0.1818309184,
                        "temporal_representativeness_data_quality_rating": 0.0599169728
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 5,
                        "geographical_representativeness_data_quality_rating": 3.03471470441,
                        "temporal_representativeness_data_quality_rating": 1
                    }
                }
            },
            "component": {
                "type": "simple",
                "product": "aluminum base",
                "metadata": null,
                "weight_kg": 0.8,
                "location": "Munich, Bavaria, Germany",
                "production": {
                    "estimate": {
                        "co2e": 6.6552004432,
                        "co2e_unit": "kg",
                        "co2e_calculation_method": "ar4",
                        "co2e_calculation_origin": "source",
                        "emission_factor": {
                            "name": "Aluminium",
                            "activity_id": "metals-type_aluminium",
                            "id": "154d3baf-ded1-41f9-9c9a-a66b8c6bf1ae",
                            "access_type": "public",
                            "source": "Circular Ecology",
                            "source_dataset": "ICE Database v4",
                            "year": 2024,
                            "region": "EU_S_AMERICA",
                            "category": "Metals",
                            "source_lca_activity": "cradle_to_gate",
                            "data_quality_flags": [
                                "notable_methodological_variance"
                            ]
                        },
                        "constituent_gases": {
                            "co2e_total": 6.6552004432,
                            "co2e_other": null,
                            "co2": null,
                            "ch4": null,
                            "n2o": null
                        },
                        "activity_data": {
                            "activity_value": 0.8,
                            "activity_unit": "kg"
                        },
                        "audit_trail": "enabled"
                    },
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 33.276002216,
                            "geographical_representativeness_data_quality_rating": 33.276002216,
                            "temporal_representativeness_data_quality_rating": 6.6552004432
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 5,
                            "geographical_representativeness_data_quality_rating": 5,
                            "temporal_representativeness_data_quality_rating": 1
                        }
                    },
                    "calculation_details": {
                        "quality_label": "accept"
                    },
                    "source_trail": [
                        {
                            "data_category": "emission_factor",
                            "name": "Aluminium",
                            "source": "Circular Ecology",
                            "source_dataset": "ICE Database v4",
                            "year": "2024",
                            "region": "EU_S_AMERICA",
                            "region_name": "Europe and South America",
                            "id": "154d3baf-ded1-41f9-9c9a-a66b8c6bf1ae"
                        }
                    ]
                },
                "notices": [
                    {
                        "message": "Estimation was performed using an emission factor from region EU_S_AMERICA due to data not being available for your region DE.",
                        "code": "emission_factor_region_fallback",
                        "severity": "warning"
                    }
                ],
                "waste": null
            }
        },
        {
            "transportation": {
                "total_co2e_kg": 0.0337065449528,
                "route": [
                    {
                        "type": "location",
                        "location": "Shenzhen, China"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 20.12
                    },
                    {
                        "type": "location",
                        "location": "Sea Port at YANTIAN"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "sea",
                        "distance_km": 19607.376435
                    },
                    {
                        "type": "location",
                        "location": "Sea Port at SZCZECIN"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 144.236
                    },
                    {
                        "type": "location",
                        "location": "Berlin, Germany"
                    }
                ],
                "well_to_tank_co2e": 0.00541021386344,
                "tank_to_wheel_co2e": 0.0268743310894,
                "logistics_hubs_co2e": 0.001422,
                "notices": [],
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 0.168532724764,
                        "geographical_representativeness_data_quality_rating": 0.127621431411,
                        "temporal_representativeness_data_quality_rating": 0.0337065449528
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 5,
                        "geographical_representativeness_data_quality_rating": 3.78625075901,
                        "temporal_representativeness_data_quality_rating": 1
                    }
                }
            },
            "component": {
                "type": "simple",
                "product": "plastic shade",
                "metadata": null,
                "weight_kg": 0.3,
                "location": "Shenzhen, China",
                "production": {
                    "estimate": {
                        "co2e": 1.11,
                        "co2e_unit": "kg",
                        "co2e_calculation_method": "ar4",
                        "co2e_calculation_origin": "source",
                        "emission_factor": {
                            "name": "Plastics",
                            "activity_id": "plastics_rubber-type_plastics",
                            "id": "3145e681-1309-47f0-bd8a-bc41e6009704",
                            "access_type": "public",
                            "source": "Bafa",
                            "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                            "year": 2025,
                            "region": "DE",
                            "category": "Plastics and Rubber Products",
                            "source_lca_activity": "cradle_to_gate",
                            "data_quality_flags": [
                                "notable_methodological_variance"
                            ]
                        },
                        "constituent_gases": {
                            "co2e_total": 1.11,
                            "co2e_other": null,
                            "co2": null,
                            "ch4": null,
                            "n2o": null
                        },
                        "activity_data": {
                            "activity_value": 0.3,
                            "activity_unit": "kg"
                        },
                        "audit_trail": "enabled"
                    },
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 5.55,
                            "geographical_representativeness_data_quality_rating": 5.55,
                            "temporal_representativeness_data_quality_rating": 1.11
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 5,
                            "geographical_representativeness_data_quality_rating": 5,
                            "temporal_representativeness_data_quality_rating": 1
                        }
                    },
                    "calculation_details": {
                        "quality_label": "accept"
                    },
                    "source_trail": [
                        {
                            "data_category": "emission_factor",
                            "name": "Plastics",
                            "source": "Bafa",
                            "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                            "year": "2025",
                            "region": "DE",
                            "region_name": "Germany",
                            "id": "3145e681-1309-47f0-bd8a-bc41e6009704"
                        }
                    ]
                },
                "notices": [
                    {
                        "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region CN.",
                        "code": "emission_factor_region_fallback",
                        "severity": "warning"
                    }
                ],
                "waste": null
            }
        }
    ]
}

Accounting for manufacturing waste

This example shows how to account for material waste during manufacturing using the waste_ratio parameter. In this case, 25% of the polypropylene pellets are wasted during the molding process:


curl --request POST \
  --url https://preview.api.climatiq.io/pcf/v1-preview2/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
    "product": "Molded plastic shade",
    "location": {
        "query": "Shenzhen"
    },
    "manufacturing_year": 2025,
    "manufacturing": [
      {
        "type": "electricity",
        "amount": {
            "energy": 2,
            "energy_unit": "kWh"
        }
      }
    ],
    "components": [
        {
            "type": "simple",
            "product": "polypropylene pellets",
            "production_year": 2025,
            "weight": {
                "weight": 0.4,
                "weight_unit": "kg"
            },
            "location": {
                "query": "Shanghai"
            },
            "waste_ratio": 0.25
        }
    ]
}'

The response includes both the end-of-life emissions for the finished product and the manufacturing waste emissions in a separate waste array:


{
    "product_id": "a655d99b-5ed9-4484-9c44-04488f45f1d2",
    "product": "Molded plastic shade",
    "metadata": null,
    "cradle_to_gate": {
        "total_co2e_kg": 2.18491630078,
        "co2e_calculation_method": "ipcc_mixed_gwp100",
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 7.06950362888,
                "geographical_representativeness_data_quality_rating": 6.64282888951,
                "temporal_representativeness_data_quality_rating": 6.44760094978
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 3.23692554822,
                "geographical_representativeness_data_quality_rating": 3.04156326578,
                "temporal_representativeness_data_quality_rating": 2.95217391979
            }
        }
    },
    "location": "Shenzhen, China",
    "manufacturing_year": 2025,
    "weight_kg": 0.3,
    "multiplier": null,
    "manufacturing": {
        "total_co2e_kg": 1.42119432,
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 3.25538528,
                "geographical_representativeness_data_quality_rating": 2.84238864,
                "temporal_representativeness_data_quality_rating": 5.68477728
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 2.2905982906,
                "geographical_representativeness_data_quality_rating": 2,
                "temporal_representativeness_data_quality_rating": 4
            }
        },
        "breakdown": [
            {
                "type": "electricity",
                "total_co2e_kg": 1.42119432,
                "metadata": null,
                "details": {
                    "generation": 1.1144,
                    "generation_wtt": 0.189448,
                    "tnd": 0.100296,
                    "tnd_wtt": 0.01705032
                },
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 3.25538528,
                        "geographical_representativeness_data_quality_rating": 2.84238864,
                        "temporal_representativeness_data_quality_rating": 5.68477728
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 2.2905982906,
                        "geographical_representativeness_data_quality_rating": 2,
                        "temporal_representativeness_data_quality_rating": 4
                    }
                },
                "notices": [
                    {
                        "severity": "warning",
                        "code": "supplier_mix_used_for_residual",
                        "message": "Unable to find a residual mix factor for the requested region, the supplier mix will be used instead, this will likely result in underestimating this portion of the energy usage"
                    },
                    {
                        "severity": "warning",
                        "code": "global_default_wtt_used",
                        "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
                    },
                    {
                        "severity": "warning",
                        "code": "global_default_wtt_used",
                        "message": "Calculating location well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor for this region."
                    }
                ],
                "source_trail": [
                    {
                        "data_category": null,
                        "name": "Default transmission & distribution loss factor for grid electricity",
                        "source": "Climatiq",
                        "source_dataset": null,
                        "year": null,
                        "region": "GLOBAL",
                        "region_name": "Global",
                        "id": null
                    },
                    {
                        "data_category": null,
                        "name": "Default well-to-tank ratio of electricity generation emissions",
                        "source": "Climatiq",
                        "source_dataset": null,
                        "year": null,
                        "region": "GLOBAL",
                        "region_name": "Global",
                        "id": null
                    },
                    {
                        "data_category": "emission_factor",
                        "name": "Electricity supplied from grid",
                        "source": "CT",
                        "source_dataset": "Climate Transparency Report",
                        "year": "2021",
                        "region": "CN",
                        "region_name": "China",
                        "id": "19f28a64-a761-4b68-a6b8-65977c67c4bf"
                    }
                ]
            }
        ]
    },
    "notices": [
        {
            "severity": "warning",
            "code": "supplier_mix_used_for_residual",
            "message": "Unable to find a residual mix factor for the requested region, the supplier mix will be used instead, this will likely result in underestimating this portion of the energy usage"
        },
        {
            "severity": "warning",
            "code": "global_default_wtt_used",
            "message": "Calculating market well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor. For more accurate market well to tank emissions, explicitly provide a fuel mix."
        },
        {
            "severity": "warning",
            "code": "global_default_wtt_used",
            "message": "Calculating location well to tank emissions using a global average proportion of generation emissions, due to absence of an applicable emissions factor for this region."
        }
    ],
    "end_of_life": {
        "total_co2e_kg": 0.002694933,
        "allocation_method": "cut_off",
        "breakdown": [
            {
                "total_co2e_kg": 0.002694933,
                "material_type": "plastic_pp",
                "total_weight_kg": 0.3,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Plastics waste disposal (landfill)",
                        "source": "BEIS",
                        "source_dataset": "Greenhouse gas reporting: conversion factors 2025",
                        "year": "2025",
                        "region": "GB",
                        "region_name": "United Kingdom",
                        "id": "57541e5f-14e6-4626-a1db-67c7b5856ee7"
                    }
                ]
            }
        ]
    },
    "use_phase": null,
    "waste": [
        {
            "total_co2e_kg": 0.000898311,
            "material_type": "plastic_pp",
            "total_weight_kg": 0.1,
            "source_trail": [
                {
                    "data_category": "emission_factor",
                    "name": "Plastics waste disposal (landfill)",
                    "source": "BEIS",
                    "source_dataset": "Greenhouse gas reporting: conversion factors 2025",
                    "year": "2025",
                    "region": "GB",
                    "region_name": "United Kingdom",
                    "id": "57541e5f-14e6-4626-a1db-67c7b5856ee7"
                }
            ]
        }
    ],
    "components": [
        {
            "transportation": {
                "total_co2e_kg": 0.0108236697769,
                "route": [
                    {
                        "type": "location",
                        "location": "Shanghai, China"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 5.66
                    },
                    {
                        "type": "location",
                        "location": "Sea Port at SHANGHAI"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "sea",
                        "distance_km": 1631.95278
                    },
                    {
                        "type": "location",
                        "location": "Sea Port at YANTIAN"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 17.76
                    },
                    {
                        "type": "location",
                        "location": "Shenzhen, China"
                    }
                ],
                "well_to_tank_co2e": 0.00146840313488,
                "tank_to_wheel_co2e": 0.007459266642,
                "logistics_hubs_co2e": 0.001896,
                "notices": [],
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 0.0541183488844,
                        "geographical_representativeness_data_quality_rating": 0.0404402495075,
                        "temporal_representativeness_data_quality_rating": 0.0108236697769
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 5,
                        "geographical_representativeness_data_quality_rating": 3.73627894616,
                        "temporal_representativeness_data_quality_rating": 1
                    }
                }
            },
            "component": {
                "type": "simple",
                "product": "polypropylene pellets",
                "metadata": null,
                "weight_kg": 0.4,
                "location": "Shanghai, China",
                "production": {
                    "estimate": {
                        "co2e": 0.752,
                        "co2e_unit": "kg",
                        "co2e_calculation_method": "ar4",
                        "co2e_calculation_origin": "source",
                        "emission_factor": {
                            "name": "Polypropylene (PP)",
                            "activity_id": "plastics_rubber-type_polypropelene",
                            "id": "b899130e-d3fa-4d2d-a016-354335a4a5e9",
                            "access_type": "public",
                            "source": "Bafa",
                            "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                            "year": 2025,
                            "region": "DE",
                            "category": "Plastics and Rubber Products",
                            "source_lca_activity": "cradle_to_gate",
                            "data_quality_flags": [
                                "notable_methodological_variance"
                            ]
                        },
                        "constituent_gases": {
                            "co2e_total": 0.752,
                            "co2e_other": null,
                            "co2": null,
                            "ch4": null,
                            "n2o": null
                        },
                        "activity_data": {
                            "activity_value": 0.4,
                            "activity_unit": "kg"
                        },
                        "audit_trail": "enabled"
                    },
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 3.76,
                            "geographical_representativeness_data_quality_rating": 3.76,
                            "temporal_representativeness_data_quality_rating": 0.752
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 5,
                            "geographical_representativeness_data_quality_rating": 5,
                            "temporal_representativeness_data_quality_rating": 1
                        }
                    },
                    "calculation_details": {
                        "quality_label": "accept"
                    },
                    "source_trail": [
                        {
                            "data_category": "emission_factor",
                            "name": "Polypropylene (PP)",
                            "source": "Bafa",
                            "source_dataset": "Informationsblatt CO2-Faktoren v3.3",
                            "year": "2025",
                            "region": "DE",
                            "region_name": "Germany",
                            "id": "b899130e-d3fa-4d2d-a016-354335a4a5e9"
                        }
                    ]
                },
                "notices": [
                    {
                        "message": "Estimation was performed using an emission factor from region DE due to data not being available for your region CN.",
                        "code": "emission_factor_region_fallback",
                        "severity": "warning"
                    }
                ],
                "waste": {
                    "total_co2e_kg": 0.000898311,
                    "material_type": "plastic_pp",
                    "total_weight_kg": 0.1,
                    "source_trail": [
                        {
                            "data_category": "emission_factor",
                            "name": "Plastics waste disposal (landfill)",
                            "source": "BEIS",
                            "source_dataset": "Greenhouse gas reporting: conversion factors 2025",
                            "year": "2025",
                            "region": "GB",
                            "region_name": "United Kingdom",
                            "id": "57541e5f-14e6-4626-a1db-67c7b5856ee7"
                        }
                    ]
                }
            }
        }
    ]
}

Manufacturing emissions with emission factor

In this example, the manufacturing contains an emission factor for fugitive gases released in the process. Note the selector for the emission factor and the response component associated with it.


{
    "product_id": "b685e405-f07f-45db-b50a-b93e07827ee9",
    "product": "Refrigerator",
    "metadata": null,
    "cradle_to_gate": {
        "total_co2e_kg": 1997.39389677,
        "co2e_calculation_method": "ipcc_mixed_gwp100",
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 9986.96948385,
                "geographical_representativeness_data_quality_rating": 7997.82229142,
                "temporal_representativeness_data_quality_rating": 7964.39389677
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 5,
                "geographical_representativeness_data_quality_rating": 4.00412873212,
                "temporal_representativeness_data_quality_rating": 3.98739272692
            }
        }
    },
    "location": "Berlin, Germany",
    "manufacturing_year": 2025,
    "weight_kg": 1,
    "multiplier": null,
    "manufacturing": {
        "total_co2e_kg": 1989,
        "data_quality": {
            "scaled": {
                "technological_representativeness_data_quality_rating": 9945,
                "geographical_representativeness_data_quality_rating": 7956,
                "temporal_representativeness_data_quality_rating": 7956
            },
            "normalized": {
                "technological_representativeness_data_quality_rating": 5,
                "geographical_representativeness_data_quality_rating": 4,
                "temporal_representativeness_data_quality_rating": 4
            }
        },
        "breakdown": [
            {
                "type": "emission_factor",
                "total_co2e_kg": 1989,
                "metadata": null,
                "details": {
                    "co2e": 1989,
                    "co2e_unit": "kg",
                    "co2e_calculation_method": "ar6",
                    "co2e_calculation_origin": "source",
                    "emission_factor": {
                        "name": "R-134a / HFC-134a (1.1.1.2-tetrafluoroethane)",
                        "activity_id": "fugitive_gas-type_hfc_134a",
                        "id": "eb336004-c64a-4935-8b66-21e6cbd624c9",
                        "access_type": "public",
                        "source": "GHG Protocol",
                        "source_dataset": "IPCC Global Warming Potential Values",
                        "year": 2021,
                        "region": "GLOBAL",
                        "category": "Refrigerants and Fugitive Gases",
                        "source_lca_activity": "fugitive_release",
                        "data_quality_flags": []
                    },
                    "constituent_gases": {
                        "co2e_total": 1989,
                        "co2e_other": 1989,
                        "co2": 0,
                        "ch4": 0,
                        "n2o": 0
                    },
                    "activity_data": {
                        "activity_value": 1.3,
                        "activity_unit": "kg"
                    },
                    "audit_trail": "selector"
                },
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 9945,
                        "geographical_representativeness_data_quality_rating": 7956,
                        "temporal_representativeness_data_quality_rating": 7956
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 5,
                        "geographical_representativeness_data_quality_rating": 4,
                        "temporal_representativeness_data_quality_rating": 4
                    }
                },
                "notices": [],
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "R-134a / HFC-134a (1.1.1.2-tetrafluoroethane)",
                        "source": "GHG Protocol",
                        "source_dataset": "IPCC Global Warming Potential Values",
                        "year": "2021",
                        "region": "GLOBAL",
                        "region_name": "Global",
                        "id": "eb336004-c64a-4935-8b66-21e6cbd624c9"
                    }
                ]
            }
        ]
    },
    "notices": [],
    "end_of_life": {
        "total_co2e_kg": 0.0220462262185,
        "allocation_method": "cut_off",
        "breakdown": [
            {
                "total_co2e_kg": 0.0220462262185,
                "material_type": "aluminum",
                "total_weight_kg": 1,
                "source_trail": [
                    {
                        "data_category": "emission_factor",
                        "name": "Aluminum Ingot - Landfilled",
                        "source": "EPA",
                        "source_dataset": "2025 GHG Emission Factors Hub",
                        "year": "2025",
                        "region": "US",
                        "region_name": "United States of America (the)",
                        "id": "24616429-727c-428e-858d-993bb70b3355"
                    }
                ]
            }
        ]
    },
    "use_phase": null,
    "waste": [],
    "components": [
        {
            "transportation": {
                "total_co2e_kg": 0.074896216,
                "route": [
                    {
                        "type": "location",
                        "location": "Munich, Bavaria, Germany"
                    },
                    {
                        "type": "leg",
                        "transport_mode": "road",
                        "distance_km": 583.034
                    },
                    {
                        "type": "location",
                        "location": "Berlin, Germany"
                    }
                ],
                "well_to_tank_co2e": 0.016907986,
                "tank_to_wheel_co2e": 0.05538823,
                "logistics_hubs_co2e": 0.0026,
                "notices": [],
                "data_quality": {
                    "scaled": {
                        "technological_representativeness_data_quality_rating": 0.37448108,
                        "geographical_representativeness_data_quality_rating": 0.227288648,
                        "temporal_representativeness_data_quality_rating": 0.074896216
                    },
                    "normalized": {
                        "technological_representativeness_data_quality_rating": 5,
                        "geographical_representativeness_data_quality_rating": 3.03471470441,
                        "temporal_representativeness_data_quality_rating": 1
                    }
                }
            },
            "component": {
                "type": "simple",
                "product": "aluminum",
                "metadata": null,
                "weight_kg": 1,
                "location": "Munich, Bavaria, Germany",
                "production": {
                    "estimate": {
                        "co2e": 8.319000554,
                        "co2e_unit": "kg",
                        "co2e_calculation_method": "ar4",
                        "co2e_calculation_origin": "source",
                        "emission_factor": {
                            "name": "Aluminium",
                            "activity_id": "metals-type_aluminium",
                            "id": "154d3baf-ded1-41f9-9c9a-a66b8c6bf1ae",
                            "access_type": "public",
                            "source": "Circular Ecology",
                            "source_dataset": "ICE Database v4",
                            "year": 2024,
                            "region": "EU_S_AMERICA",
                            "category": "Metals",
                            "source_lca_activity": "cradle_to_gate",
                            "data_quality_flags": [
                                "notable_methodological_variance"
                            ]
                        },
                        "constituent_gases": {
                            "co2e_total": 8.319000554,
                            "co2e_other": null,
                            "co2": null,
                            "ch4": null,
                            "n2o": null
                        },
                        "activity_data": {
                            "activity_value": 1,
                            "activity_unit": "kg"
                        },
                        "audit_trail": "enabled"
                    },
                    "data_quality": {
                        "scaled": {
                            "technological_representativeness_data_quality_rating": 41.59500277,
                            "geographical_representativeness_data_quality_rating": 41.59500277,
                            "temporal_representativeness_data_quality_rating": 8.319000554
                        },
                        "normalized": {
                            "technological_representativeness_data_quality_rating": 5,
                            "geographical_representativeness_data_quality_rating": 5,
                            "temporal_representativeness_data_quality_rating": 1
                        }
                    },
                    "calculation_details": {
                        "quality_label": "accept"
                    },
                    "source_trail": [
                        {
                            "data_category": "emission_factor",
                            "name": "Aluminium",
                            "source": "Circular Ecology",
                            "source_dataset": "ICE Database v4",
                            "year": "2024",
                            "region": "EU_S_AMERICA",
                            "region_name": "Europe and South America",
                            "id": "154d3baf-ded1-41f9-9c9a-a66b8c6bf1ae"
                        }
                    ]
                },
                "notices": [
                    {
                        "message": "Estimation was performed using an emission factor from region EU_S_AMERICA due to data not being available for your region DE.",
                        "code": "emission_factor_region_fallback",
                        "severity": "warning"
                    }
                ],
                "waste": null
            }
        }
    ]
}