Discovery

Coverage — which countries we hold data for, and how much

Open (no key). Per country: how many of 13 inventory families we hold, the row count in each, and a band (complete / partial / minimal). Answer "do you cover my country?" before integrating. Derived from the live corpus at request time, so it cannot drift from the data. Measures PRESENCE, not sufficiency — a country showing fuel:7 has seven fuel rows, which may not answer a given question; the response repeats this in a caveat field. Returns counts only, never factor values.

get/v1/coverage

Request

  • Base URL: https://api.greencalculus.com
  • URL: https://api.greencalculus.com/v1/coverage
  • Auth: none required

Query parameters

countrystring

One or more ISO-3166 alpha-3 codes, comma-separated.

familystring

Only countries holding data in this family.

min_scoreinteger

Only countries covering at least this many of the 13 families.

Response

Coverage matrix + meta (families, bands, filters) + caveat

coverageobject

Keyed by ISO3.

caveatstring
docsstring uri

Example response

{
  "meta": {
    "countries": 151
  },
  "receipt": {
    "id": "gcr_5a7b64dfa501bfea508cba7d0e5d8d03…",
    "algorithm": "sha256",
    "mb_version": "2026.180"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.