Calculate

Batch — up to 100 mixed-methodology calculations in one call

post/v1/calculate/batch

Request

  • Base URL: https://api.greencalculus.com
  • URL: https://api.greencalculus.com/v1/calculate/batch
  • Auth: HTTP bearer

Query parameters

as_ofstring
Example:2026.175

Run this calculation against an ARCHIVED data version. Every factor used is the row as it stood at that version, and meta.gc_version, meta.version_pin, the citation and the receipt all report it. Unlike GET /v1/factors/{key}?as_of=, an unavailable version is REFUSED (400) rather than served from current data with a label: a calculation returns a single figure that goes into a report under a receipt, so it must be the version it claims. A factor key that did not exist yet at that version is refused for the same reason. Archived versions are listed in the error, and by GET /v1/factors/{key}?as_of= on a miss.

Request body

Example request

{
  "items": [
    {
      "methodology": "ghg-activity"
    }
  ]
}

Response

Per-item results + summed total

methodologystring
countinteger
succeededinteger
failedinteger
totalobject

The summed emissions across items that succeeded.

resultsobject[]

One entry per input item, in order. Each is the engine's own response shape, or an error for that item alone.

proof_urlsstring[]

Every factor used by this answer, as a public proof URL pinned to the data version. A portfolio calculation may list many; cite per line from here. Contains no request data — each URL is a fact about the GreenCalculus corpus and is identical for every caller.

Example response

{
  "methodology": "batch",
  "meta": {
    "gc_version": "2026.180",
    "gc_updated": "2026-08-19"
  },
  "receipt": {
    "id": "gcr_5a7b64dfa501bfea508cba7d0e5d8d03…",
    "algorithm": "sha256",
    "mb_version": "2026.180"
  }
}

Changes

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