Capabilities / Activity-based emissions
The activity endpoint converts a physical quantity — fuel burned, electricity used, materials consumed — into verified CO₂e. Choose from 1,000+ activity types, specify a country and year, and receive Scope 1 or 2 emissions with the factor's methodology, source, licence, gas basis and GWP version. Batch up to 100 items via /v1/activity/batch.
POST /v1/activity · $0.003 / call · API key or x402 pay-per-call
curl -s https://api.myco2suite.io/v1/activity \
-H "content-type: application/json" \
-H "x-api-key: $MYCO2_API_KEY" \
-d '{"activity_type":"electricity","quantity":1000,"country":"GB"}'{
"co2e_kg": 207.74,
"factor": {
"value": 0.20774,
"unit": "kWh",
"label": "UK grid electricity",
"source": "UK Government GHG Conversion Factors (DEFRA)",
"licence": "OGL v3.0",
"scope": "scope_2"
}
}| Field | Required | Description |
|---|---|---|
| activity_type | Yes | e.g. electricity, diesel, natural_gas |
| quantity | Yes | Amount in the activity's native unit (> 0) |
| country | No | ISO 3166-1 alpha-2 (defaults to GLO) |
| year | No | Data year |
Get a key instantly, or let your agents pay per call in USDC via x402 — no signup.
Get your free API key