Vehicle Fuels API
The Vehicle Fuels API allows you to retrieve and manage fuel types available for vehicles in your organization. Each fuel type includes associated emission factors and units of measurement for accurate CO2e calculations.Reference Data: This API provides reference data for fuel types used when creating or updating vehicles. Fuel types define how emissions are calculated based on vehicle usage.
Key Features
- Fuel Type Catalog: Browse all available fuel types for your vehicles
- Emission Factors: View standardized emission factors per fuel type
- Unit Management: Access fuel units and conversion factors
- Country-Specific: Get fuel data specific to different countries
- Reference Data: Use IDs from this API when creating vehicles
Authentication
All endpoints require authentication using an API key included in thex-api-key header.
Headers
All requests should include:string
required
Your API key for authenticationFormat: Your API key string
Available Endpoints
List Vehicle Fuels
Retrieve all available fuel types with emission factors and units
Fuel Types
Common fuel types include:Fuel Units
Fuel can be measured in various units:Fuel Object Structure
Workflow
Using Fuel Types with Vehicles
- List available fuels using
GET /v1/vehicle-fuels - Select a fuel type for your vehicle based on:
- Fuel type (petrol, diesel, electric, etc.)
- Country (emission factors vary by region)
- Use the fuel ID when creating or updating vehicles with
vehicle_fuel_id
Common Usage Patterns
Error Handling
Common HTTP Status Codes
Error Response Format
Use Cases
Build Fuel Selection UI
Display available fuels in your application:Compare Emissions by Fuel Type
Analyze how fuel type affects emissions:Related Documentation
Create Vehicle
Create vehicles with specific fuel types
List Vehicles
View vehicles and their fuel assignments
Unknown Vehicles
Browse vehicle type classifications
Vehicles API
Manage your vehicle fleet
Rate Limiting
API requests are subject to rate limiting. Include rate limit information from response headers:X-RateLimit-Limit: Maximum requests per minuteX-RateLimit-Remaining: Requests remainingX-RateLimit-Reset: Unix timestamp when limit resets