{"openapi":"3.1.0","info":{"title":"Carbon Footprint API","version":"1.0.0","description":"Estimate CO2e emissions for everyday activities using the official DEFRA 2023 GHG conversion factors: road and rail travel (per kilometre by vehicle type, split across passengers), flights (by airport IATA pair with great-circle distance, or by distance, across cabin classes and round trips), grid electricity (by kilowatt-hour and country carbon intensity) and direct fuel combustion (by litres and fuel type). A factors endpoint exposes every emission factor, supported vehicle and fuel type, and the country grid-intensity table. Each result returns CO2e in kilograms, tonnes and grams. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side compute (no third-party upstream), so responses are instant and always available. Ideal for travel and booking flows, sustainability dashboards, ESG and Scope-3 reporting, and carbon-aware product features.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/carbonfootprint-api","description":"oanor gateway"}],"tags":[{"name":"Carbon"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/electricity":{"get":{"operationId":"get_v1_electricity","tags":["Carbon"],"summary":"Grid electricity emissions","description":"","parameters":[{"name":"kwh","in":"query","required":true,"description":"Energy in kWh","schema":{"type":"string"},"example":"1000"},{"name":"country","in":"query","required":false,"description":"ISO-2 country code or WORLD","schema":{"type":"string"},"example":"DE"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/factors":{"get":{"operationId":"get_v1_factors","tags":["Carbon"],"summary":"All emission factors & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/flight":{"get":{"operationId":"get_v1_flight","tags":["Carbon"],"summary":"Air travel emissions","description":"","parameters":[{"name":"from","in":"query","required":false,"description":"Origin airport IATA","schema":{"type":"string"},"example":"LHR"},{"name":"to","in":"query","required":false,"description":"Destination airport IATA","schema":{"type":"string"},"example":"JFK"},{"name":"distance_km","in":"query","required":false,"description":"Distance (if no airports)","schema":{"type":"string"},"example":"5500"},{"name":"class","in":"query","required":false,"description":"economy|premium|business|first","schema":{"type":"string"},"example":"economy"},{"name":"passengers","in":"query","required":false,"description":"Passengers","schema":{"type":"string"},"example":"1"},{"name":"round_trip","in":"query","required":false,"description":"Round trip","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fuel":{"get":{"operationId":"get_v1_fuel","tags":["Carbon"],"summary":"Fuel combustion emissions","description":"","parameters":[{"name":"liters","in":"query","required":true,"description":"Litres of fuel","schema":{"type":"string"},"example":"40"},{"name":"fuel_type","in":"query","required":false,"description":"petrol|diesel|lpg|kerosene|heating_oil","schema":{"type":"string"},"example":"diesel"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/vehicle":{"get":{"operationId":"get_v1_vehicle","tags":["Carbon"],"summary":"Road/rail travel emissions","description":"","parameters":[{"name":"distance_km","in":"query","required":true,"description":"Distance in km","schema":{"type":"string"},"example":"100"},{"name":"vehicle","in":"query","required":false,"description":"car_petrol|car_diesel|car_electric|bus|train_national|...","schema":{"type":"string"},"example":"car_petrol"},{"name":"passengers","in":"query","required":false,"description":"Split across passengers","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":22000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":750,"monthly_call_quota":280000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":2200000,"rps_limit":40,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5800,"monthly_call_quota":11000000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/carbonfootprint-api"}