Capabilities / Freight emissions
The freight endpoint calculates logistics CO₂e from weight and distance across road, rail, sea and air — single-leg or multi-leg intermodal. Locations accept UN/LOCODE, IATA, free-text names or coordinates; the response returns tonne-kilometres, distance and the mode factor with its provenance.
POST /v1/freight · $0.003 / call · API key or x402 pay-per-call
curl -s https://api.myco2suite.io/v1/freight \
-H "content-type: application/json" \
-H "x-api-key: $MYCO2_API_KEY" \
-d '{"mode":"sea","weight_kg":20000,"origin":"GBSOU","destination":"SGSIN"}'{
"co2e_kg": 1520.44,
"co2e_tonnes": 1.52044,
"route": {
"distance_km": 15320.5,
"tonne_km": 306410
},
"factor": {
"unit": "kgCO2e/tonne.km",
"source": "IMO GHG Study"
}
}| Field | Required | Description |
|---|---|---|
| weight_kg | Yes | Shipment weight in kilograms (> 0) |
| mode | Yes | sea | road | rail | air (single-leg) |
| origin | Yes | UN/LOCODE, IATA, name, or origin_lat + origin_lon |
| destination | Yes | UN/LOCODE, IATA, name, or destination_lat + destination_lon |
| legs | No | Multi-leg: array of { mode, origin, destination } (omit top-level mode/origin/destination) |
Get a key instantly, or let your agents pay per call in USDC via x402 — no signup.
Get your free API key