🧩Factor

Find emission factors in the Carbonlink Emission Factor Database

[Public] - API Key is not required to call Factor endpoints.

Search for a set of emission factors

GET https://api.carbonlink.io/v1/factors

Query Parameters

Name	Type	Description
criteria	string	Set of fields and operations to parse into Search Query Language for filtering the Emission Factor Database
fullTextSearch	string	Raw set of words or phrases to search for in the Emission Factor Database.

200: OK Returns an array of Factor objects

[
    {
      id: "fct_12345678",
      rate: 12,
      unit: "usd",
      basis: "SPEND",
      name: "Mid-sized Freight Ship",
      code: "MID_FREIGHT",
      sector: "transport",
      category: "transport freight by ship",
      releaseYear: 2023,
      version: 0,
      source: 'EXIOBASE',
    },
    ...
]

Search for potential emission factors related to a Product

GET https://api.carbonlink.io/v1/factors/searchByProduct

Query Parameters

Name	Type	Description
name*	string	Name of Product to find related factors for
description*	string	Description of Product to find related factors for

200: OK Returns an array of Factor objects ranked by relation to the Product details provided

[
    {
      id: "fct_12345678",
      rate: 12,
      unit: "usd",
      basis: "SPEND",
      name: "Mid-sized Freight Ship",
      code: "MID_FREIGHT",
      sector: "transport",
      category: "transport freight by ship",
      releaseYear: 2023,
      version: 0,
      source: 'EXIOBASE',
    },
    ...
]