Loading...

by Saint Sita Ram Innovation Lab Pvt Ltd

Latency --
Success Rate --
Last Updated --

Description

This API works after fetching vehicle details from the Vehicle Suite APIs (Makers, Models, Fuel & Capacities). Developers must pass the correct combination of:

🏭 Maker (string) – Vehicle manufacturer name

πŸš— Model (string) – Model name linked to the maker

β›½ Fuel Type (string) – Accepted values: "petrol", "diesel", "cng"

βš™οΈ Cubic Capacity (integer) – Engine displacement (in cc)

πŸ—ΊοΈ State Name (string) – The user’s state, required to map fuel prices and calculate cost per km

The API returns:

πŸ”‘ A unique model_id for downstream calculations

πŸ“‹ Basic vehicle info: maker, model, fuel type, cubic capacity

πŸ“Š Performance data:

Speed-wise mileage

Cost per km (fuel cost factored from user’s state)

COβ‚‚ emissions

πŸ‘‰ With this information, developers can integrate personalized and location-based vehicle performance into routing, pricing, and sustainability features.

API Details

API Version

1.0.0

This is the current version of the API available for use.

ssrapi/get-vehicle-info

POST ssrapi/get-vehicle-info

This API provides vehicle-specific performance data based on: ● Maker ● Model ● Fuel Type ● Engine Cubic Capacity ● User's State Name It returns: ● A unique model_id to be used in downstream fuel-efficient route calculations ● Maker name, Model name, fuel type, cubic capacity ● Speed-wise mileage, cost per km, and COβ‚‚ emissions

Parameters

ParameterTypeDescriptionExample
maker* Text (String) Vehicle manufacturer name (e.g., "Tata") Tata , BMW
model* Text (String) Model name (e.g., "Ace"), should be based on the maker. maker tata, model ace
fuel_type* Text (String) petrol, diesel, or cng petrol, diesel, or cng
cubic_capacity* Text (String) Engine capacity in cc (e.g., "694") Engine capacity in cc (e.g., "694")
state_name* Text (String) User current state name (e.g., β€œPunjab”) User current state name (e.g., β€œPunjab”)

Example Request

{
"maker": "Tata",
"model": "Ace",
"fuel_type": "petrol",
"cubic_capacity": "694",
"state_name": β€œPunjab”
}

Example Response

{
"model_id": 21789,
"maker_name": "Tata",
"model_name": "Ace",
"fuel_type": "Petrol",
"cubic_capacity": "694cc",
"state_used": "Punjab",
"state_info": {
"requested_input": "coordinates: 30.211,74.9455",
"final_state_used": "Punjab"
},
"vehicle_data": [
{
"speed": "30",
"mileage": "19.0",
"cost_per_km": "5.2",
"emission": "120"
},
...
]
}

Support

For any questions or issues, please contact our support team at info@ssrinnovationlab.com