Loading...

by Saint Sita Ram Innovation Lab Pvt Ltd

Latency --
Success Rate --
Last Updated --

Description

The Vehicle Suite API provides structured vehicle information in three stages:

1. Get the maker (brand) of the vehicle.

2. Get the models available for that maker.

3. Get the fuel types and engine capacities (cc) available for that model.

This API is the foundation for the Vehicle Info API — developers must first use it to fetch the correct maker, model, fuel type, and cubic capacity before requesting vehicle performance data from the "Vehicle Info API".

🔗 End-to-End Vehicle Suite Flow

1️⃣ Call Vehicle Makers API → get list of makers
2️⃣ Pick a maker_id → call Vehicle Models API
3️⃣ Pick a model_id → call Vehicle Fuel and Capacities API
4️⃣ Use the data →

🏭 maker (string) → Vehicle brand name

🚗 model (string) → Model name

⛽ fuel_type (string) → "petrol", "diesel", or "cng"

⚙️ cubic_capacity (integer) → Engine capacity in cc

🗺️ state_name (string) → User’s state name (used to fetch fuel prices, required for cost-per-km calculation)

➡️ Call Vehicle Info API to get performance data (mileage, cost/km, emissions).

API Details

API Version

1.0.0

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

Vehicle Makers API

GET ssrapi/vehicle-makers

This endpoint returns the list of vehicle makers (brands) available for a given vehicle type (car or motorcycle) . It is the first step in the Vehicle Suite flow, where you start by choosing a maker. Required Parameter: 🚦 vehicle_type (string) → Accepts "car" or "motorcycle"

Parameters

ParameterTypeDescriptionExample
vehicle_type* Text (String) car or motorcycle car

Example Request

GET /ssrapi/vehicle-makers?vehicle_type=car

Example Response

{
  "data": [
    { "maker__name": "Maruti Suzuki", "maker_id": 1 },
    { "maker_name": "Hyundai", "maker_id": 53 },
    { "maker__name": "Tata", "maker_id": 7 }
  ]
}

👉 Use maker__id from here in the Vehicle Models API.

Vehicle Models API

GET ssrapi/vehicle-models

Fetches the list of vehicle models for a specific maker and vehicle type. Required Parameters: 🚦 vehicle_type (string) → "car" or "motorcycle" 🏭 vehicle_maker_id (integer) → Maker ID from Vehicle Makers API

Parameters

ParameterTypeDescriptionExample
vehicle_maker_id* Number (Integer) Use the maker_id you received from the Vehicle Makers API response as input here 1
vehicle_type* Text (String) car or motorcycle car

Example Request

GET /ssrapi/vehicle-models?vehicle_type=car&vehicle_maker_id=53

Example Response

{
  "data": [
    { "model_id": 1, "name": "Vitara Brezza" },
    { "model_id": 2, "name": "A star" },
    { "model_id": 3, "name": "Alto K10" },
    { "model_id": 5,  "name": "Maruti 800" },
    { "model_id": 6, "name": "Alto 800" }
  ]
}

👉 Use model_id from here in the Vehicle Fuel Type and Capacities API.

Vehicle Fuel Type & Capacities API

GET ssrapi/vehicle-fuel-and-capacities

Returns detailed information about the fuel types and engine capacities (CC) for a specific vehicle model. Required Parameter: 🚗 model_id (integer) → Model ID from Vehicle Models API

Parameters

ParameterTypeDescriptionExample
model_id* Number (Integer) Use the model_id you received from the Vehicle Models API response as input here 10

Example Request

GET /ssrapi/vehicle-fuel-and-capacities?model_id=562

Example Response

{
  "success": true,
  "data": {
    "model_info":  {
      "model_name": "i20",
      "maker_id": 53,
      "vehicle_type": "CAR"
    },
    "fuel_types": {
      "diesel": [
        { "capacity" : 1396, "model_ids": [563] }
      ],
      "petrol": [
        { "capacity": 998, "model_ids": [7756] },
        { "capacity": 1197, "model_ids": [562] },
        { "capacity":  1368, "model_ids": [21821] }
      ]
    },
    "summary": {
      "total_fuel_types": 2,
      "total_capacities": 6,
      "available_fuel_types": ["diesel",  "petrol"]
    }
  }
}

Support

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