API Reference
All endpoints require authentication via Bearer token. See Authentication for details.
Base URL: https://api.emissions.dev
Travel API
Calculate CO2e emissions for passenger travel — flights, rail, car, bus, ferry, and taxi.
| Endpoint | Description |
|---|---|
GET /v1/travel/emissions |
Calculate travel emissions |
Hotel API
Calculate CO2e emissions for hotel accommodation in 60+ countries.
| Endpoint | Description |
|---|---|
GET /v1/hotel/emissions |
Calculate hotel emissions |
GET /v1/hotel/compare |
Compare countries |
GET /v1/hotel/factors |
List all country factors |
Freight API
Calculate CO2e emissions for cargo shipments by road, rail, sea, and air.
| Endpoint | Description |
|---|---|
GET /v1/freight/emissions |
Calculate freight emissions |
Digital API (Beta)
Estimate CO2e emissions from LLM inference — 80+ models across 12 providers.
| Endpoint | Description |
|---|---|
GET /v1/digital/llm/emissions |
Calculate LLM emissions |
GET /v1/digital/llm/models |
Supported models |
Common Features
All endpoints share these response features:
| Feature | Description |
|---|---|
source_trail |
Full audit trail of emission factors used |
equivalents |
Real-world comparisons (opt-in via equivalents=true) |
notices |
Warnings about estimates or data limitations |
meta |
Methodology, version, and compliance info |