Usage notes

Frammenti di codice

curl "https://api.oanor.com/carbonintensity-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/carbonintensity-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/carbonintensity-api/v1/meta");
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/carbonintensity-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "note": "Great Britain electricity grid carbon intensity. /v1/intensity = the current national carbon intensity in gCO2/kWh (actual, forecast & index very low→very high); /v1/generation = the live generation mix by fuel (gas, wind, solar, nuclear, biomass, imports…) with renewable & zero-carbon percentages; /v1/forecast = today's half-hourly intensity timeline; /v1/regional = the 18 GB regions' intensity & mix; /v1/postcode?postcode=RG10 = intensity & mix for a UK postcode (outward code); /v1/factors = the gCO2/kWh emission factor of each fuel type. Covers Great Britain. Ideal for timing EV charging and appliances to the greenest hours.",
        "source": "National Grid ESO Carbon Intensity API (carbonintensity.org.uk)",
        "endpoints": [
            "/v1/intensity",
            "/v1/generation",
            "/v1/forecast",
            "/v1/regional",
            "/v1/postcode",
            "/v1/factors",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:40.269Z",
        "request_id": "ce3f965a-f9b1-4d10-89b1-13fb1cc25194"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}