Need to manage API keys, view logs, or check usage?Open the Developer portal →

List characterization methods

Every characterization method (e.g. IPCC 2021, ReCiPe 2016) available across the library. Each method exposes one or more impact categories — the rows you see on process impacts.

GET/public/impact-methods

A characterization method defines how raw elementary flows (emissions, resource extractions, etc.) are converted into impact scores. Each method (e.g. IPCC 2021) covers one or more impact categories (GWP100, ozone depletion, …).

On GET /processes/:id, each row in impacts[] carries a method name that matches one returned here. To pull impact values, see POST /processes/:id/impacts/pull.

Response

200OK
{
  "items": [
    {
      "id": "8c2a17a4-1234-4d1e-9b21-3a8e2c91c0a1",
      "name": "IPCC 2021",
      "version": "no LT"
    },
    {
      "id": "9e1bc7d2-4567-4a8e-bb31-5d8b9c01e0c2",
      "name": "ReCiPe 2016",
      "version": "v1.03 midpoint (H) no LT"
    }
  ],
  "total": 2
}

Methods are returned sorted alphabetically by name. Multiple versions of the same family (e.g. ReCiPe midpoint vs. endpoint) appear as separate entries.

Example

curl -s 'https://api.circa.ai/public/impact-methods' \
  -H 'x-api-key: circa_live_xxx' \
  -H 'x-team-id: TEAM_ID_FROM_OVERVIEW' \
  -H 'Circa-Version: 2026-05-11.arrakis'