Capabilities / Flight emissions
The flight endpoint calculates great-circle CO₂e for a journey by airport (IATA / UN-LOCODE) or lat-long, cabin class and passenger count, with optional radiative forcing. Factors follow the UK BEIS/DESNZ 2025 methodology; the response returns per-passenger and total emissions with distance and haul type.
POST /v1/flight · $0.003 / call · API key or x402 pay-per-call
curl -s https://api.myco2suite.io/v1/flight \
-H "content-type: application/json" \
-H "x-api-key: $MYCO2_API_KEY" \
-d '{"origin":"LHR","destination":"JFK","cabin_class":"economy","passengers":1}'{
"co2e_kg": 986.4,
"per_passenger_kg": 986.4,
"flight": {
"gcd_km": 5541,
"haul_type": "long_haul"
},
"factor": {
"unit": "gCO2e/passenger.km",
"source": "BEIS 2025",
"licence": "OGL v3.0"
}
}| Field | Required | Description |
|---|---|---|
| origin | Yes | IATA (LHR) or UN/LOCODE; or origin_lat + origin_lon |
| destination | Yes | IATA (JFK) or UN/LOCODE; or destination_lat + destination_lon |
| cabin_class | No | economy | premium_economy | business | first |
| passengers | No | Passenger count (default 1) |
| include_radiative_forcing | No | Add the RF multiplier (default false) |
Get a key instantly, or let your agents pay per call in USDC via x402 — no signup.
Get your free API key