Factor API: officiella brittiska och nationella emissionsfaktorer för din programvara

Så fungerar det

1. Logga in och öppna Factor API i appen. Skapa en nyckel och kopiera den (den visas bara en gång).
2. Skicka den med varje förfrågan som Authorization: Bearer crf_….
3. Läs data och visa källtexten överallt där siffrorna visas.

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

Nycklar förvaras på din server, inte på en webbsida. API:et är skrivskyddat (GET), svarar i JSON, tillåter förfrågningar mellan ursprung (CORS) och är versionshanterat: allt som skulle kunna bryta din kod kommer i en ny version, inte i v1.

Referens för slutpunkter

Basadress https://carbonrecycling.co.uk/api/v1. GET /api/v1 listar slutpunkter och källor utan nyckel. För brittiska faktorer är year DESNZ-uppsättningen (2002 till 2026, standard är den senaste). För el per land och amerikansk region är year ditt redovisningsår, och svaret är det senaste dataåret fram till det.

En brittisk faktor efter 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 }
}

Brittisk el, med residualmixen

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": "..."
}

Ett land

recommended följer samma regel som våra egna rapporter: landets officiella siffra, om inte Embers är mer än ett år nyare.

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": "..."
}

Fel och gränser

Fel returneras som {"error": {"status", "code", "message"}}. 400 vid felaktig parameter, 401 vid saknad eller återkallad nyckel, 403 när Factor API inte ingår i kontot (med en länk för att teckna abonnemang), 404 för okänd faktor, okänt land eller okänd slutpunkt, och 429 när månadens anrop är förbrukade.

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"
  }
}

Licenser och källhänvisningar

Vi levererar bara data vars licens tillåter att de förs vidare i en betald produkt, och vi sparar en daterad kopia av varje utgivares villkor. Varje svar listar källorna bakom det med licens och den källhänvisning som ska visas. Siffrorna är som de publicerats, utan garanti, och ingen av utgivarna står bakom Carbon Recycling eller din produkt.

• Department for Energy Security and Net Zero (DESNZ): UK Government GHG Conversion Factors for Company Reporting. Open Government Licence v3.0. Källa: Innehåller information från den offentliga sektorn som licensieras enligt Open Government Licence v3.0. Källa: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: Utgiftsbaserade emissionsmultiplikatorer (Storbritanniens klimatavtryck). Open Government Licence v3.0. Källa: Innehåller information från den offentliga sektorn som licensieras enligt Open Government Licence v3.0. Källa: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: Standardvärden och CBAM-satser enligt UK CBAM. Open Government Licence v3.0. Källa: Innehåller information från den offentliga sektorn som licensieras enligt Open Government Licence v3.0. Källa: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury och HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC: Ember Yearly Electricity Data (elnätets intensitet per land). Creative Commons Erkännande 4,0 Internationell. Källa: Innehåller data från Ember, licensierad enligt CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency: EPA eGRID och GHG Emission Factors Hub (till och med utgåvan 2025). US government work, public domain under 17 U.S.C. § 105. Källa: US EPA, eGRID och GHG Emission Factors Hub. Inte lagstadgat, men vi anger källan.
• Miljö och klimatförändringar Kanada: Kanada National Inventory Report, bilaga 7, tabeller över elintensitet. Open Government Licence - Canada 2.0. Källa: Innehåller information som licensieras enligt Open Government Licence – Kanada (Environment and Climate Change Kanada, National Inventory Report).
• Energy Market Authority, Singapore: Singapore Energy Market Authoritys emissionsfaktorer för elnätet (data.gov.sg). Singapore Open Data Licence version 1.0. Källa: Innehåller information från Electricity Grid Emission Factors och Upstream Fugitive Methane Emission Factor, hämtad den 19 oktober 2026 från data.gov.sg, som görs tillgänglig enligt villkoren i Singapore Open Data Licence version 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone (öppen kopia på data.ademe.fr), el. Licence Ouverte / Open Licence 2.0 (Etalab). Källa: Source: ADEME, Base Carbone® V23.6 (data.ademe.fr, senast uppdaterad 3 juli 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (utgåvorna 2022 till 2026). Creative Commons Erkännande 4,0 Internationell. Källa: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, augusti. CC BY 4,0. (Tidigare utgåvor anges på samma sätt med sitt eget år.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (el enligt eGRID2024, GWP-värden enligt AR6). Creative Commons Erkännande 4,0 Internationell. Källa: 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): Datatabell för redovisning av bränslemix (brittisk residualmix). Open Government Licence v3.0. Källa: Innehåller information från den offentliga sektorn som licensieras enligt Open Government Licence v3.0. Källa: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: Umweltbundesamt: specifika växthusgasutsläpp från den tyska elmixen 1990 till 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Källa: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Värdena har räknats om från g till kg per kWh av Carbon Recycling.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministeriet för ekologi och miljö samt Nationella statistikbyrån: nationella emissionsfaktorer för CO2 från el 2021 till 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Källa: Ministry of Ecology and Environment och National Bureau of Statistics i Kina, tillkännagivanden 2024 nr 12, 2024 nr 33 och 2025 nr 47 (nationell genomsnittlig emissionsfaktor för CO2 från el).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Nya Zeeland): Measuring emissions, emissionsfaktorer 2026 v2 (CSV i långt format), köpt el. Creative Commons Erkännande 4,0 Internationell. Källa: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (version 2). Crown copyright, licensieras enligt CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (sökning av plats från postnummer, endast postnummer i Storbritannien exkl. Nordirland). Open Government Licence v3.0. Källa: Innehåller data från Ordnance Survey © Crown copyright och databasrätt. Innehåller data från Royal Mail © Royal Mail upphovsrätt och databasrätt. Innehåller data från National Statistics © Crown copyright och databasrätt. Innehåller data från NRS © Crown copyright och databasrätt. Postnummersökning via postcodes.io.
• Environment Agency: Environment Agencys API för översvämningsövervakning i realtid (områden för översvämningsvarning och beredskap, aktuella varningar). Open Government Licence v3.0. Källa: Här används Environment Agencys data om översvämningar och vattennivåer från realtids-API:et (beta).
• Environment Agency: Environment Agency Risk of Flooding from Rivers and Sea, and from Surface Water (NaFRA2), nuläge och med klimatförändringar, via Defras WMS. Open Government Licence v3.0. Källa: © Environment Agency upphovsrätt och/eller databasrätt 2025. Med ensamrätt. Innehåller information från den offentliga sektorn som licensieras enligt Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA): SEPA Flood Maps (floder, kust samt ytvatten och små vattendrag; nuläge och framtid), öppen karttjänst. Open Government Licence v3.0. Källa: ©SEPA 2025; denna SEPA-produkt licensieras enligt Open Government Licence version 3,0.
• Natural Resources Wales: Natural Resources Wales Flood Risk Assessment Wales (floder, hav, ytvatten och små vattendrag) och områden med översvämningsvarning, via DataMapWales. Open Government Licence v3.0. Källa: Innehåller information från Natural Resources Wales © Natural Resources Body for Wales och databasrätt. Med ensamrätt. Uppskattningar av översvämningsflöden bygger på FEH-metod och data, © och databasrätt UKCEH 2015. Innehåller data från Ordnance Survey, Crown copyright och databasrätt. Licensieras enligt Open Government Licence v3.0.
• Met Office: Met Office Climate Data Portal: UKCP18-prognoser per kommun vid olika nivåer av global uppvärmning (varma sommardagar, tropiska nätter, maximal sommartemperatur, nederbörd sommar och vinter). Open Government Licence v3.0. Källa: Innehåller data från Met Office som licensieras enligt Open Government Licence v3.0. Innehåller data från OS och ONS © Crown copyright och databasrätt. Källa: Met Office Climate Data Portal, UKCP18 local authority projections.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xeros redovisnings-API (kundens egen huvudbok)
• EXIOBASE 3 multiregional input-output (utgiftsfaktorer för alla länder)
• IEA:s emissionsfaktorer
• ecoinvent
• SEAI:s omräknings- och emissionsfaktorer (Irland), fliken GHG_elec (el 2001 till 2025)
• DESNZ:s faktorer för el utomlands i uppsättningen för 2021 och tidigare, som byggdes på IEA-data under IEA:s egen licens

Deras villkor förbjuder vidareförsäljning eller vidarespridning av data, så de ingår inte i API:et. Se vår sida om datakällor för hela förteckningen.