Factor API: officiële Britse en landelijke emissiefactoren voor uw software

Zo werkt het

1. Log in en open Factor API in de app. Maak een sleutel aan en kopieer die (hij wordt één keer getoond).
2. Stuur hem bij elk verzoek mee als Authorization: Bearer crf_….
3. Lees data en toon de attribution-tekst overal waar de cijfers verschijnen.

curl -H "Authorization: Bearer $FACTOR_API_KEY" \
  "https://carbonrecycling.co.uk/api/v1/uk/factors?year=2026&q=diesel&category=fuels&scope=1"

Sleutels worden op uw server bewaard, niet in een webpagina. De API is alleen-lezen (GET), antwoordt in JSON, staat cross-origin-verzoeken toe en heeft versiebeheer: alles wat uw code zou breken komt in een nieuwe versie, niet in v1.

Endpointreferentie

Basisadres https://carbonrecycling.co.uk/api/v1. GET /api/v1 toont de endpoints en bronnen zonder sleutel. Voor Britse factoren is year de DESNZ-set (2002 tot en met 2026, standaard de meest recente). Voor elektriciteit per land en Amerikaanse regio is year uw verslagjaar en is het antwoord het meest recente gegevensjaar tot en met dat jaar.

Een Britse factor op ID

GET https://carbonrecycling.co.uk/api/v1/uk/factors/7_400_4000_5_1?year=2026

{
  "data": {
    "id": "7_400_4000_5_1",
    "year": 2026,
    "scope": "Scope 2",
    "category": "UK electricity",
    "path": ["UK electricity", "Electricity generated", "Electricity: UK", "kWh", null],
    "description": "UK electricity › Electricity generated › Electricity: UK › kWh",
    "unit": "kWh",
    "kgCo2ePerUnit": 0.13096
  },
  "attribution": [
    {
      "source": "desnz-factors",
      "name": "UK Government GHG Conversion Factors for Company Reporting",
      "publisher": "Department for Energy Security and Net Zero (DESNZ)",
      "licence": "Open Government Licence v3.0",
      "licenceUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
      "attribution": "Contains public sector information licensed under the Open Government Licence v3.0. Source: DESNZ, Greenhouse gas reporting: conversion factors."
    }
  ],
  "notice": "Figures as published by each source, supplied without warranty. Carbon Recycling is not endorsed by any of the publishers named in attribution.",
  "meta": { "year": 2026 }
}

Britse elektriciteit, met de residumix

GET https://carbonrecycling.co.uk/api/v1/uk/electricity?year=2026

{
  "data": {
    "year": 2026,
    "locationBased": { "id": "7_400_4000_5_1", "kgCo2ePerKwh": 0.13096, "scope": "Scope 2", "description": "UK electricity › ..." },
    "transmissionAndDistribution": { "id": "13_402_4000_5_1", "kgCo2ePerKwh": 0.01299, "scope": "Scope 3", "description": "..." },
    "wellToTank": {
      "generation": { "id": "15_917_4000_5_1", "kgCo2ePerKwh": 0.03682, "scope": "Scope 3", "description": "..." },
      "transmissionAndDistribution": { "id": "15_918_4000_5_1", "kgCo2ePerKwh": 0.00359, "scope": "Scope 3", "description": "..." }
    },
    "residualMix": { "kgCo2PerKwh": 0.396, "dataYear": 2025, "period": "1 April 2025 to 31 March 2026", "basis": "UK residual fuel mix, CO2 only, ..." }
  },
  "attribution": [ { "source": "desnz-factors", ... }, { "source": "desnz-fuel-mix", ... } ],
  "notice": "..."
}

Een land

recommended volgt dezelfde regel als onze eigen rapporten: het officiële cijfer van het land, tenzij dat van Ember meer dan een jaar recenter is.

GET https://carbonrecycling.co.uk/api/v1/electricity/countries/FRA?year=2025

{
  "data": {
    "iso3": "FRA",
    "name": "France",
    "reportingYear": 2025,
    "recommended": {
      "year": 2024,
      "kgCo2ePerKwh": 0.035,
      "source": "fr-ademe-base-carbone",
      "dataset": "Base Carbone V23.6, electricity average mix (combustion at the power station)",
      "basis": "..."
    },
    "ember": { "dataset": "Ember, Yearly Electricity Data", "generationTwh": 570.1, "mixPercent": { "Nuclear": 68.8, ... },
               "years": [ ..., { "year": 2025, "kgCo2ePerKwh": 0.04145 } ] },
    "official": { "publisher": "ADEME", "years": [ ..., { "year": 2024, "kgCo2ePerKwh": 0.035 } ], ... }
  },
  "attribution": [ { "source": "ember", ... }, { "source": "fr-ademe-base-carbone", ... } ],
  "notice": "..."
}

Fouten en limieten

Fouten worden teruggegeven als {"error": {"status", "code", "message"}}. 400 bij een ongeldige parameter, 401 bij een ontbrekende of ingetrokken sleutel, 403 als Factor API niet op het account staat (met een link om u te abonneren), 404 bij een onbekende factor, land of endpoint, en 429 zodra de oproepen van de maand op zijn.

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1793491200
Retry-After: 1080000

{
  "error": {
    "status": 429,
    "code": "monthly_limit_reached",
    "message": "This account has used its 10,000 calls for this month. The count starts again on 2026-11-01, or move to a bigger tier.",
    "limit": 10000,
    "resetsAt": "2026-11-01T00:00:00.000Z",
    "upgrade": "https://carbonrecycling.co.uk/products/factor-api"
  }
}

Licenties en bronvermelding

We leveren alleen gegevens waarvan de licentie toestaat dat ze in een betaald product worden doorgegeven, en we bewaren een gedateerde kopie van de voorwaarden van elke uitgever. Elk antwoord vermeldt de onderliggende bronnen met hun licentie en de te tonen bronvermelding. De cijfers zijn zoals gepubliceerd, zonder garantie, en geen van de uitgevers onderschrijft Carbon Recycling of uw product.

• Department for Energy Security and Net Zero (DESNZ): UK Government GHG Conversion Factors for Company Reporting. Open Government Licence v3.0. Bronvermelding: Bevat informatie uit de publieke sector, gelicentieerd onder de Open Government Licence v3.0. Bron: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: emissiemultiplicatoren op basis van uitgaven (CO₂-voetafdruk van het Verenigd Koninkrijk). Open Government Licence v3.0. Bronvermelding: Bevat informatie uit de publieke sector, gelicentieerd onder de Open Government Licence v3.0. Bron: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: standaardwaarden en tarieven voor de Britse CBAM. Open Government Licence v3.0. Bronvermelding: Bevat informatie uit de publieke sector, gelicentieerd onder de Open Government Licence v3.0. Bron: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury en HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC: Ember Yearly Electricity Data (netintensiteit per land). Creative Commons Naamsvermelding 4,0 Internationaal. Bronvermelding: Bevat gegevens van Ember, gelicentieerd onder CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency: EPA eGRID en GHG Emission Factors Hub (tot en met de editie 2025). US government work, public domain under 17 U.S.C. § 105. Bronvermelding: Bron: US EPA, eGRID en GHG Emission Factors Hub. Niet wettelijk verplicht, maar we vermelden de bron toch.
• Environment and Climate Change Canada: National Inventory Report van Canada, bijlage 7, tabellen met elektriciteitsintensiteit. Open Government Licence - Canada 2.0. Bronvermelding: Bevat informatie gelicentieerd onder de Open Government Licence – Canada (Environment and Climate Change Canada, National Inventory Report).
• Energy Market Authority, Singapore: netemissiefactoren van de Energy Market Authority van Singapore (data.gov.sg). Singapore Open Data Licence version 1.0. Bronvermelding: Bevat informatie uit Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor, geraadpleegd op 19 oktober 2026 via data.gov.sg, beschikbaar gesteld onder de voorwaarden van de Singapore Open Data Licence versie 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone (open kopie op data.ademe.fr), elektriciteit. Licence Ouverte / Open Licence 2.0 (Etalab). Bronvermelding: Bron: ADEME, Base Carbone® V23.6 (data.ademe.fr, laatst bijgewerkt 3 juli 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (edities 2022 tot en met 2026). Creative Commons Naamsvermelding 4,0 Internationaal. Bronvermelding: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, augustus. CC BY 4,0. (Eerdere edities worden op dezelfde manier vermeld, met hun eigen jaar.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (eGRID2024-elektriciteit, AR6-GWP's). Creative Commons Naamsvermelding 4,0 Internationaal. Bronvermelding: Emission Factors Hub 2026, Cornerstone Sustainability Data Initiative, CC BY 4,0 (doi:10,5281/zenodo.20403776).
• Department for Energy Security and Net Zero (DESNZ): gegevenstabel van het stroometiket (Britse residumix). Open Government Licence v3.0. Bronvermelding: Bevat informatie uit de publieke sector, gelicentieerd onder de Open Government Licence v3.0. Bron: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: Umweltbundesamt: specifieke broeikasgasemissies van de Duitse elektriciteitsmix 1990 tot en met 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Bronvermelding: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Cijfers door Carbon Recycling omgerekend van g naar kg per kWh.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministry of Ecology and Environment en National Bureau of Statistics: nationale CO2-emissiefactoren voor elektriciteit 2021 tot en met 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Bronvermelding: Bron: Ministry of Ecology and Environment en National Bureau of Statistics van China, bekendmakingen 2024 nr. 12, 2024 nr. 33 en 2025 nr. 47 (nationale gemiddelde CO2-emissiefactor voor elektriciteit).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Nieuw-Zeeland): Measuring emissions, emissiefactoren 2026 v2 (csv in lang formaat), ingekochte elektriciteit. Creative Commons Naamsvermelding 4,0 Internationaal. Bronvermelding: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (versie 2). Crown copyright, gelicentieerd onder CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (opzoeken van locatie bij postcode, alleen postcodes in Groot-Brittannië). Open Government Licence v3.0. Bronvermelding: Bevat gegevens van Ordnance Survey © Crown copyright en databankrecht. Bevat gegevens van Royal Mail © Royal Mail copyright en databankrecht. Bevat gegevens van National Statistics © Crown copyright en databankrecht. Bevat gegevens van NRS © Crown copyright en databankrecht. Postcodeopzoekingen via postcodes.io.
• Environment Agency: real-time API voor overstromingsmonitoring van de Environment Agency (gebieden met overstromingswaarschuwingen en -meldingen, actuele waarschuwingen). Open Government Licence v3.0. Bronvermelding: Hierbij worden overstromings- en rivierpeilgegevens van de Environment Agency gebruikt uit de realtime data-API (bèta).
• Environment Agency: Environment Agency Risk of Flooding from Rivers and Sea, and from Surface Water (NaFRA2), huidige situatie en klimaatverandering, via de WMS van Defra. Open Government Licence v3.0. Bronvermelding: © Environment Agency copyright en/of databankrecht 2025. Alle rechten voorbehouden. Bevat informatie uit de publieke sector, gelicentieerd onder de Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA): SEPA-overstromingskaarten (rivieren, kust, oppervlaktewater en kleine waterlopen; huidig en toekomstig), open kaartdienst. Open Government Licence v3.0. Bronvermelding: ©SEPA 2025; dit SEPA-product is gelicentieerd onder de Open Government Licence versie 3,0.
• Natural Resources Wales: Natural Resources Wales Flood Risk Assessment Wales (rivieren, zee, oppervlaktewater en kleine waterlopen) en gebieden met overstromingswaarschuwingen, via DataMapWales. Open Government Licence v3.0. Bronvermelding: Bevat informatie van Natural Resources Wales © Natural Resources Body for Wales en databankrecht. Alle rechten voorbehouden. Schattingen van overstromingsdebieten zijn gebaseerd op FEH-methodologie en -gegevens, © en databankrecht UKCEH 2015. Bevat gegevens van Ordnance Survey, Crown copyright en databankrecht. Gelicentieerd onder de Open Government Licence v3.0.
• Met Office: Met Office Climate Data Portal: UKCP18-projecties per lokale overheid bij mondiale opwarmingsniveaus (hete zomerdagen, tropische nachten, maximale zomertemperatuur, neerslag in zomer en winter). Open Government Licence v3.0. Bronvermelding: Bevat gegevens van het Met Office, gelicentieerd onder de Open Government Licence v3.0. Bevat gegevens van OS en ONS © Crown copyright en databankrecht. Bron: Met Office Climate Data Portal, UKCP18 local authority projections.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xero boekhoud-API (de eigen grootboekadministratie van de klant)
• EXIOBASE 3 multiregionale input-outputtabellen (uitgavenfactoren voor elk land)
• IEA-emissiefactoren
• ecoinvent
• SEAI-conversie- en emissiefactoren (Ierland), tabblad GHG_elec (elektriciteit 2001 tot en met 2025)
• De buitenlandse elektriciteitsfactoren van DESNZ in de set van 2021 en eerder, die zijn opgesteld met IEA-gegevens onder de eigen licentie van het IEA

Hun voorwaarden sluiten doorverkoop of herdistributie van de gegevens uit, dus deze blijven buiten de API. Zie onze pagina gegevensbronnen voor het volledige overzicht.