Vehicles
Discover supported vehicle manufacturers and models.
Vehicles Estimates by Type
Emissions from Vehicle Usage based on its type
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) for travel in vehicles based on its type.
operationId: calculate_emissions_from_vehicle_usage_based_on_type
query Parameters
vehicle_typeType of vehicle
distance_unitEnter "km" for kilometers and "mi" for miles. Default is "km"
distance_valueDistance travelled. If an undefined value is passed, it will be set to 1.00
fuel_typeApplicable for cars, these 5 values are allowed: ["Diesel", "Petrol", "PHEV", "BEV", "Unknown"]. If unsure then use "Unknown", which is the default value.
include_wttThe default value of "Y" includes the Well-to-Tank (WTT) factors while "N" bypasses it
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Vehicles Estimates by Type › Responses
Estimated vehicle emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Vehicles Estimates by Model
Emissions from Vehicle Usage based on its Make/Model
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) for travel in vehicles based on its make and model.
145 Makes and 5,000 models are covered. To get the specific name of make and model, use the supplementary APIs or access the database at: https://www.carbonsutra.com/data-vehicle-make-model
operationId: calculate_emissions_from_vehicle_usage_based_on_make_and_model
Notes
-
If you do not know the make and model of vehicle, we suggest to use the API which calculates emissions by Vehicle Type.
-
For dual fuel vehicles, the average of emissions from its conventional and alternative fuels is used.
-
If a model is released across multiple years by the same maker, then the emissions for that model are averaged.
query Parameters
vehicle_makeName of Vehicle Make. Retrieve it from Supplementary API or documentation
vehicle_modelName of Vehicle Model. Retrieve it from Supplementary API or documentation
distance_unitEnter "km" for kilometers and "mi" for miles. Default is "mi".
distance_valueDistance travelled. If an undefined value is passed, it will be set to 1.00
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Vehicles Estimates by Model › Responses
Estimated vehicle emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Vehicle Makes
List of all Vehicle Makes
Returns a list of all vehicle makers and their number of models, which can be used in getting list of models and then estimating footprints.
This API is primarily used by application developers. For individual users, we have shared the entire database at: https://www.carbonsutra.com/
operationId: list_all_vehicle_makers
Vehicle Makes › Responses
Vehicle makes and model counts.
Vehicle Models
List of all Models for a specific Vehicle Make
Returns a list of all models for a specific vehicle maker's name. This API is primarily used by application developers.
operationId: list_all_models_for_a_specific_vehicle_make
path Parameters
vehicle_makeName of Vehicle Make
Vehicle Models › Responses
Vehicle models for the selected make.