{"uid":"cap_ZeStxnuQTzf8JpceGfmyM","slug":"gb-carbon-intensity-by-postcode-532d3173","name":"GB Carbon Intensity by Postcode","description":"Forecast carbon intensity of Great Britain electricity for the current half hour in the region of a postcode, with the generation mix, as JSON.","url":"https://pennydatahq.com/api/carbon/:postcode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["postcode"],"properties":{"postcode":{"type":"string","description":"Great Britain postcode or outward code (the first half, such as RG10), with or without the space, any case. Northern Ireland (BT) is not on the GB grid and is not supported."}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["postcode"],"properties":{"to":{"type":["string","null"],"description":"End of the half hour, ISO 8601 UTC"},"from":{"type":["string","null"],"description":"Start of the half hour, ISO 8601 UTC"},"region":{"type":["string","null"]},"postcode":{"type":"string","description":"Outward code"},"dno_region":{"type":["string","null"],"description":"Distribution network operator area"},"generation_mix":{"type":"object","description":"Percent by fuel","additionalProperties":{"type":"number"}},"intensity_index":{"type":["string","null"],"description":"very low, low, moderate, high or very high"},"intensity_gco2_per_kwh":{"type":["number","null"],"description":"Regional forecast"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DgVObijP2FTZqL0K3Dla0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the forecast carbon intensity (gCO2/kWh) and electricity generation mix for the current half-hour period in the GB grid region corresponding to a given postcode.","exampleAgentPrompt":"What's the carbon intensity of the electricity grid right now at postcode SW1A — tell me the gCO2/kWh figure, the intensity index, and the current generation mix by fuel type.","exampleUseCases":[{"title":"Smart EV charging timing","prompt":"Is right now a low-carbon time to charge my electric car at home in Leeds — what's the current grid intensity and index for postcode LS1?"},{"title":"Renewable energy share check","prompt":"What percentage of the electricity in the Edinburgh area is coming from renewable sources right now? My postcode is EH1."},{"title":"Carbon-aware appliance scheduling","prompt":"I want to run my washing machine at the greenest possible time today — what's the current carbon intensity index for RG10, and is it very low, low, or moderate?"}],"resultDescription":"A JSON object containing: the postcode outward code, the start and end timestamps of the current half-hour window (ISO 8601 UTC), the regional name and DNO area, the forecast carbon intensity in gCO2/kWh, a human-readable intensity index (very low / low / moderate / high / very high), and a generation mix object showing percentage contribution from each fuel type (e.g. wind, solar, gas, nuclear, biomass, imports).","failureModes":["Unsupported postcode (e.g. Northern Ireland BT postcodes not on GB grid) — returns error","Invalid or malformed postcode format — may return 4xx error","Upstream Carbon Intensity API unavailable — may return 5xx or stale data","Postcode not recognised — region lookup fails","Payment not included or insufficient — x402 payment required response"],"whenToPreferThis":"Use this endpoint when you need real-time, postcode-level carbon intensity data for Great Britain, especially when regional granularity matters (rather than a national average). It is ideal for carbon-aware scheduling, green energy dashboards, EV charging optimisation, or any agent workflow that needs to act on current grid conditions for a specific UK location. Prefer this over generic energy APIs when you need both the gCO2/kWh figure AND the generation mix in a single lightweight call at very low cost per lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:34.430Z","isFirstParty":false,"canonicalSlug":"gb-carbon-intensity-by-postcode-532d3173"}