Skip to main content

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 the x-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

  1. List available fuels using GET /v1/vehicle-fuels
  2. Select a fuel type for your vehicle based on:
    • Fuel type (petrol, diesel, electric, etc.)
    • Country (emission factors vary by region)
  3. 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:

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 minute
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Unix timestamp when limit resets