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

Retrieve a process impact

Fetch a single impact row on a process. Useful when you only care about one (method, indicator) pair and don't want to download the full process payload.

GET/public/processes/:id/impacts/:impactId

Companion to GET /public/processes/:id — same masking, but returns only the named impact row. If the impact doesn't belong to the given process, you get a clean 404Not Found instead of silently returning an impact from a different process.

Path parameters

ParameterTypeDescription
idrequiredstring (uuid)The process id.
impactIdrequiredstring (uuid)The id of the impact row to retrieve.

Response

200OK
{
  "id": "ip_3a1f9c0b-1234-4d1e-9b21-3a8e2c91c0a1",
  "method": "IPCC 2021 no LT",
  "impactCategory": "climate change",
  "indicator": "global warming potential (GWP100) no LT",
  "value": 1.4202,
  "unit": "kg CO2-Eq",
  "revealed": true,
  "deleted": false
}

If revealed is false, every sensitive numeric field (value, mean, standardDeviation, …) is masked to null. Purchase access via POST /processes/:id/impacts/pull.

Errors

404Not Foundwhen the process doesn't exist, the impact doesn't exist on this process, or either record is soft-deleted.

Example

curl -s 'https://api.circa.ai/public/processes/bfffd26f…/impacts/ip_3a1…' \
  -H 'x-api-key: circa_live_xxx' \
  -H 'x-team-id: TEAM_ID_FROM_OVERVIEW' \
  -H 'Circa-Version: 2026-05-11.arrakis'