Vehicles
Discover supported vehicle manufacturers and models.
Calculate vehicle emissions by type
Calculates estimated CO₂e emissions for vehicle travel when the vehicle is identified by type rather than by a specific make and model.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
vehicle_typeType of vehicle.
distance_unitDistance unit. Default is km.
distance_valueDistance travelled. Undefined values are treated as 1.00.
fuel_typeFuel type for cars.
include_wttControls inclusion of Well-to-Tank (WTT) emissions. Default: Y.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate vehicle emissions by type › Responses
Estimated vehicle emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate vehicle emissions by make and model
Calculates estimated CO₂e emissions using a supported vehicle manufacturer and model. Use the vehicle catalog endpoints to discover supported makes and models.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
vehicle_makeVehicle make.
vehicle_modelVehicle model.
distance_unitDistance unit. The collection documents mi as the default.
distance_valueDistance travelled. Undefined values are treated as 1.00.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate vehicle emissions by make and model › Responses
Estimated vehicle emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
List supported vehicle makes
Returns supported vehicle manufacturers and their model counts. This endpoint is intended for applications that need to populate vehicle-selection interfaces.
List supported vehicle makes › Responses
Vehicle makes and model counts.
List models for a vehicle make
Returns supported vehicle models for the specified vehicle manufacturer.
path Parameters
vehicle_makeName of the vehicle make.
List models for a vehicle make › Responses
Vehicle models for the selected make.