Skip to content
GET /v1/factors

All emission factors & options

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/carbonfootprint-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/carbonfootprint-api/v1/factors" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/carbonfootprint-api/v1/factors", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/carbonfootprint-api/v1/factors");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/carbonfootprint-api/v1/factors",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "source": "DEFRA 2023 GHG conversion factors; grid intensities Ember/OWID 2023; airport coords OpenFlights",
        "vehicle_types": [
            "car_petrol",
            "car_diesel",
            "car_hybrid",
            "car_electric",
            "car_average",
            "motorbike",
            "bus",
            "coach",
            "train_national",
            "train_metro",
            "tram",
            "bicycle",
            "walking"
        ],
        "flight_classes": {
            "first": 4,
            "economy": 1,
            "premium": 1.6,
            "business": 2.9
        },
        "grid_countries": [
            "WORLD",
            "US",
            "GB",
            "DE",
            "FR",
            "ES",
            "IT",
            "NL",
            "BE",
            "PL",
            "SE",
            "NO",
            "DK",
            "FI",
            "CH",
            "AT",
            "IE",
            "PT",
            "GR",
            "CN",
            "IN",
            "JP",
            "KR",
            "AU",
            "CA",
            "BR",
            "RU",
            "ZA",
            "MX",
            "ID",
            "TR",
            "SA",
            "AE",
            "NG",
            "EG",
            "AR",
            "CL",
            "NZ",
            "IS",
            "PK",
            "TH",
            "VN",
            "MY",
            "PH",
            "UA"
        ],
        "airports_available": 6072,
        "flight_bands_kg_per_km": {
            "domestic": 0.246,
            "long_haul": 0.148,
            "short_haul": 0.151,
            "international": 0.139
        },
        "fuel_types_kg_per_liter": {
            "lpg": 1.51,
            "diesel": 2.68,
            "petrol": 2.31,
            "kerosene": 2.54,
            "heating_oil": 2.96
        },
        "grid_intensity_g_per_kwh": {
            "AE": 492,
            "AR": 307,
            "AT": 158,
            "AU": 549,
            "BE": 167,
            "BR": 99,
            "CA": 120,
            "CH": 45,
            "CL": 288,
            "CN": 531,
            "DE": 381,
            "DK": 180,
            "EG": 478,
            "ES": 156,
            "FI": 79,
            "FR": 56,
            "GB": 238,
            "GR": 341,
            "ID": 622,
            "IE": 326,
            "IN": 713,
            "IS": 28,
            "IT": 331,
            "JP": 494,
            "KR": 436,
            "MX": 423,
            "MY": 585,
            "NG": 307,
            "NL": 328,
            "NO": 29,
            "NZ": 97,
            "PH": 611,
            "PK": 419,
            "PL": 662,
            "PT": 190,
            "RU": 361,
            "SA": 659,
            "SE": 41,
            "TH": 513,
            "TR": 434,
            "UA": 234,
            "US": 369,
            "VN": 475,
            "ZA": 709,
            "WORLD": 480
        },
        "vehicle_factors_kg_pe
…