Calculate

PCAF Part A financed emissions (attribution + audit trail)

Version pinning is NOT available on this engine: the pin resolves keys named *factor_key, and this endpoint is addressed by sector_key, or by caller-supplied emissions with no factor at all. Sending ?as_of= here is a 400 rather than a silent fall back to current data — a calculation that carries a receipt has to be the version it claims.

post/v1/calculate/pcaf

Request

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

Request body

asset_classstring
holdingsobject[] required

Each holding may carry its own optional country, overriding the request-level one — a portfolio routinely spans economies, and the spend-based intensity used for one borrower may come from a different country than the next.

countrystring

Optional. The country the ACTIVITY belongs to — ISO3, ISO2 or a name ("deu", "DE", "Germany"). When given, the response carries factor.resolution stating whether the factor used is published for that country (tier: exact), is a global figure applied to it (global), or belongs to a different country (proxy, with proxy_of naming which). Omit it and no geography claim is made — the response is unchanged. A country we do not recognise yields no claim rather than a wrong one.

Example request

{
  "country": "deu"
}

Response

Financed emissions + weighted data-quality score + audit

methodologystring
standardstring
asset_classstring nullable

The single asset class, when every holding shares one; null for a mixed portfolio.

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": "pcaf",
  "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.