Skip to main content

List emission factors

Query Parameters
limitstring^\d+$

Maximum number of resources to return, between 1 and 100.

afterstring

A cursor for use in pagination.

The cursor that points to the starting item of the next page of results. If not provided, the first page of results is returned.

namestring

Search for emission factors (case insensitive). A combination of semantic and keyword search is used to provide the most relevant results.

sourcearray of enum

Filter emission factors based on source. When omitted, all sources are returned.

publication_yeararray of number

Filter emission factors based on the publication year.

regionarray of string

Filter emission factors based on region (case insensitive). When omitted, all regions are returned.

The region_fallback parameter controls how region is interpreted, by default an exact match is required.

Countries are included in regions but there are also broader geographic regions like Europe or Asia.

region_fallbackenum

Controls how region is interpreted and if region fallback is performed.

Region fallback is looking up emission factors for regions related to the specified regions.

  • never (the default) means no region fallback is performed and only emission factors that match the specified region(s) are returned.
  • always means the emission factors for related regions are unconditionally included in the results.
Enum:
  • never
  • always
unitstring

Filter emission factors based on the logical unit. When omitted, all units are returned.

Returns
has_morebooleanrequired

Whether or not there are more elements available after this set.

If false, this set comprises the end of the array.

Part of a paginated response.

next_cursorstringrequired

The cursor value to be used as the after parameter for fetching the next page of results.

null if has_more is false.

dataarray of objectrequired

An array of Emission Factor objects, ordered by best match.

Part of a paginated response.

  • GET /emission-factors
    • curl 'https://api.lune.co/v1/emission-factors' \
  -H 'Authorization: Bearer <API_KEY>'
  • Response
    • {
  "has_more": true,
  "next_cursor": "next_cursor",
  "data": [
    {
      "id": "ljmkOq7vXd238gAE9WALWQ8ZGVD5ExNz",
      "name": "Steel Pipe",
      "source": "exiobase",
      "source_version": "1.0",
      "publication_year": 2021,
      "numerator_unit": "t",
      "denominator_unit": "GBP",
      "created_at": "2022-09-01T00:00:00.000Z",
      "region": "region",
      "category": "category"
    }
  ]
}