Capabilities / Spend-based emissions
The MyCO2 spend-based endpoint converts a financial transaction into verified CO₂e. Send a spend amount, currency, country and an industry code (MCC, NAICS, BEA, ISIC, SIC or NACE); it returns Scope 3 emissions in grams, kilograms and tonnes, with the exact emission factor, methodology, source and licence used.
POST /v1/transaction · $0.003 / call · API key or x402 pay-per-call
curl -s https://api.myco2suite.io/v1/transaction \
-H "content-type: application/json" \
-H "x-api-key: $MYCO2_API_KEY" \
-d '{"mcc":"5411","spend_amount":100,"currency":"USD","country":"US"}'{
"co2e_kg": 28.45,
"co2e_tonnes": 0.02845,
"factor": {
"value": 0.2845,
"unit": "kg_co2e_per_usd",
"source": "US EPA USEEIO v2.1",
"licence": "Public Domain",
"scope": "scope_3"
}
}| Field | Required | Description |
|---|---|---|
| spend_amount | Yes | Amount spent (> 0) |
| currency | Yes | ISO 4217 currency, e.g. USD |
| country | Yes | ISO 3166-1 alpha-2, e.g. US |
| mcc | No | Merchant Category Code (or bea_code / naics / isic / sic / nace — one required) |
| year | No | Reporting year |
Get a key instantly, or let your agents pay per call in USDC via x402 — no signup.
Get your free API key