Discovery

Source feed — one publisher's dataset, whole

Open (no key). Every row we hold from one public-domain publisher, with that publisher's licence, issuing body and retrieval date, and the exact source reference behind each value. Feeds exist for a NAMED SET of sources, not for every source id in the corpus — a source we have not cleared for republication has no feed, and asks for one are refused rather than quietly answered from somewhere else. The id is case-insensitive. Everything else in the corpus is readable through GET /v1/factors, which carries the same values, provenance and licence per row.

get/v1/sources/{id}

Request

  • Base URL: https://api.greencalculus.com
  • URL: https://api.greencalculus.com/v1/sources/{id}
  • Auth: none required

Path parameters

idstring required

Source id, case-insensitive. Currently DEFRA_2026, DEFRA_2025, EMBER_YEARLY_ELECTRICITY_2025.

Response

The publisher record plus every factor transcribed from it

schema_versionstring
api_endpointstring

The origin route this feed is projected from.

datasetstring
gc_versionstring
gc_updatedstring date
next_updatestring

When the publisher next issues, and how long we take to reconcile — stated so a stale figure is predictable rather than a surprise.

attributionobject
sourcesobject[]

The publisher record: id, name, issuing body, url, licence, year, retrieval date.

countinteger

Example response

{
  "schema_version": "1.0",
  "dataset": "UK DEFRA fuel combustion emission factors (2026)",
  "gc_version": "2026.182",
  "factors": [
    {
      "key": "grid.gbr.electricity.location_based",
      "section": "grid",
      "activity_type": "purchased_energy",
      "factor": {
        "unit": "kg CO2e per kWh",
        "gas": "CO2e",
        "gwp_set": "AR5_100",
        "country_iso3": "gbr",
        "uncertainty": {
          "basis": "published"
        }
      },
      "source": {
        "id": "DEFRA_2026",
        "cell_ref": "'UK electricity'!E25",
        "retrieved": "2026-06-18"
      },
      "scope": {
        "ghg_protocol": "scope2"
      },
      "citation": {
        "text": "UK grid electricity — location-based (generation). UK Government GHG Conversion Factors 2026 — Department for Energy Security and Net Zero (DESNZ), cell 'UK electricity'!E25, retrieved 2026-06-18. via GreenCalculus data version 2026.186, factor grid.gbr.electricity.location_based. https://verify.greencalculus.com/grid.gbr.electricity.location_based@2026.186",
        "source_id": "DEFRA_2026",
        "cell_ref": "'UK electricity'!E25",
        "version": "2026.186",
        "proof_url": "https://verify.greencalculus.com/grid.gbr.electricity.location_based@2026.186"
      },
      "licence": {
        "name": "Open Government Licence v3.0"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.