GreenCalculus API
API by GreenCalculus · rest
Sourced greenhouse-gas emission factors and audit-traced carbon calculations. Every value returns with its exact source reference and data version — reproducible and citable. Free key at https://greencalculus.com/developers/. SCOPE: this document describes every endpoint we publish a callable example for — the data, calculation, discovery and watch endpoints. It deliberately excludes the control plane behind greencalculus.com (billing, sign-in, key management, admin), which is not a customer contract and is free to change, and /v1/account/webhook, whose configuration is session-only by design and therefore cannot be exercised with the bearer token this document describes. Those exclusions are enumerated and enforced by scripts/check-openapi-drift.mjs, so an endpoint is absent here because it was excluded, never because it was forgotten.
Endpoint: https://api.greencalculus.com/
Verification: observed. Source: crawl.
Capabilities (30)
- Absence — why a factor is NOT in the corpus
- The factor keys this account is alerted on
- Watch a factor key
- What changed for your watched keys between two dates
- Read the summary cadence
- Set the summary cadence
- Stop watching a factor key
- Batch — up to 100 mixed-methodology calculations in one call
- Business travel — distance × passengers × factor
- IMO CII — a ship's carbon intensity and its A-E rating 2023-2030
- Scope 2 electricity — location + market (dual reporting)
- Whole-life embodied carbon (EN 15978 modular boundary-aware)
- Freight (GLEC) — the factor's denominator picks the method: mass × distance…
- Activity → emissions (activity × factor with unit conversion + working + scope)
- PCAF Part A financed emissions (attribution + audit trail)
- Resolve — plain-text description → ranked factor keys + confidence
- Spend-based EEIO — spend × intensity (currency-matched no FX)
- Change feed — what each data release changed
- One release — every row it added changed or withdrew
- Check — which published factor is each of your numbers and is it still right?
- Full consolidated factor feed (Business plan and above)
- Coverage — which countries we hold data for and how much
- Browse/search the corpus (open — no key values included)
- Resolve one factor by canonical key (value + full provenance)
- Version history — what this factor has been