MENU navbar-image

🚗 AutoHub API

AutoHub vehicle API for US vehicle specs, values, recalls, and dealers.

Make, model, and trim lists come from the EPA (fueleconomy.gov). Their makeId and modelId values are the EPA names, and the trim vehicle_id is the EPA vehicle id that /recalls accepts. VIN decoding, details, and recalls also use NHTSA data. Autocomplete, details, car value, depreciation, and dealers use KBB data. Car value and depreciation need the KBB vehicle_id returned by /vin, not the EPA id from /trims.

Vehicle Discovery & Lookup

Look up makes, models, and trims, and decode VINs. Use these endpoints to get the ids the other vehicle endpoints expect.

GET /v1/autocomplete

requires authentication

Returns KBB make and model suggestions for a partial search term. Each item has a type of make or model, the KBB make and model codes, and a display name.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/autocomplete'
params = {
  'search': 'Tundra',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/autocomplete';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'search' => 'Tundra',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/autocomplete"
);

const params = {
    "search": "Tundra",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/autocomplete?search=Tundra" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
      "version": "v1.0",
      "status": 200,
      "copywrite": "https://steadyapi.com",
      "search": "tesla",
      "total": 10
    },
    "body": [
      {
        "type": "model",
        "make": "TESLA",
        "model": "TESMODS",
        "name": "Tesla Model S"
      },
      {
        "type": "model",
        "make": "TESLA",
        "model": "TESMODX",
        "name": "Tesla Model X"
      },
      { ... }
    ]
  }
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/autocomplete

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
search required string

Make or model name, or part of one (up to 255 characters). Example: Tundra

GET /v1/make

requires authentication

Lists the makes the EPA (fueleconomy.gov) has for a model year. Each makeId is the make name; pass it to /model.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/make'
params = {
  'year': '2025',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/make';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2025',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/make"
);

const params = {
    "year": "2025",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/make?year=2025" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "year": "2025",
    "total": 48
  },
  "body": [
    {
      "makeId": "Acura",
      "name": "Acura"
    },
    {
      "makeId": "Alfa Romeo",
      "name": "Alfa Romeo"
    },
    { ... }
  ]
}

 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/make

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Four-digit model year. Example: 2025

GET /v1/model

requires authentication

Lists the EPA models for a model year and make. Each modelId is the EPA model name, which often includes the drivetrain (for example CX-5 4WD); pass it to /trims.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/model'
params = {
  'year': '2025',
  'makeId': 'Mazda',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/model';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2025',
            'makeId' => 'Mazda',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/model"
);

const params = {
    "year": "2025",
    "makeId": "Mazda",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/model?year=2025&makeId=Mazda" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "year": "2025",
    "makeId": "Mazda",
    "total": 12
  },
  "body": [
    {
      "modelId": "3 4-Door 2WD",
      "name": "3 4-Door 2WD"
    },
    {
      "modelId": "3 4-Door 4WD",
      "name": "3 4-Door 4WD"
    },
    { ... }
  ]
}

 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/model

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Four-digit model year. Example: 2025

makeId required string

Make name returned as makeId by /make. Numeric ids are rejected with a 422. Example: Mazda

GET /v1/trims

requires authentication

Lists the EPA trim options for a year, make, and model. Each item has a name that describes the engine and transmission, and the EPA vehicle_id.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/trims'
params = {
  'year': '2025',
  'makeId': 'Mazda',
  'modelId': 'CX-5 4WD',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/trims';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2025',
            'makeId' => 'Mazda',
            'modelId' => 'CX-5 4WD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/trims"
);

const params = {
    "year": "2025",
    "makeId": "Mazda",
    "modelId": "CX-5 4WD",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/trims?year=2025&makeId=Mazda&modelId=CX-5+4WD" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "year": "2025",
        "makeId": "Mazda",
        "modelId": "CX-5 4WD",
        "total": 3
    },
    "body": [
        {
            "name": "Auto (S6), 4 cyl, 2.5 L, SIDI",
            "vehicle_id": "48537"
        },
        {
            "name": "Auto (S6), 4 cyl, 2.5 L, SIDI; with cylinder deactivation",
            "vehicle_id": "48538"
        },
        {
            "name": "Auto (S6), 4 cyl, 2.5 L, Turbo, SIDI",
            "vehicle_id": "48539"
        }
    ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/trims

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Four-digit model year. Example: 2025

makeId required string

Make name returned by /make. Numeric ids are rejected with a 422. Example: Mazda

modelId required string

Model name returned as modelId by /model. Example: CX-5 4WD

GET /v1/vin

requires authentication

Decodes a VIN. KBB supplies the vehicle_id and option ids used by /car-value and /depreciation, plus trim, body style, engine, transmission, and drivetrain. NHTSA vPIC supplies the year, make, and model, and fills any spec field KBB left empty.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/vin'
params = {
  'vin': 'jm3kkbha5r1166850',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/vin';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'vin' => 'jm3kkbha5r1166850',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/vin"
);

const params = {
    "vin": "jm3kkbha5r1166850",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/vin?vin=jm3kkbha5r1166850" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "vin": "JM3KKBHA5R1166850",
        "has_results": true
    },
    "body": {
        "using_cads": true,
        "vehicle_id": 466424,
        "year": "2024",
        "make": "MAZDA",
        "model": "CX-90",
        "vehicle_option_ids": [
            11519922,
            11519914
        ],
        "additional_option_ids": [
            11519951,
            11519989,
            11519992
        ],
        "trim_name": "Preferred Sport Utility 4D",
        "body_style": "SUV",
        "engine": "4-Cyl, e-SKYACTIV, Hybrid, 2.5 Liter",
        "transmission": "Automatic, 8-Spd e-SKYACTIV-Drive w/Manual Mode",
        "drivetrain": "AWD"
    }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/vin

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
vin required string

17-character Vehicle Identification Number. Example: jm3kkbha5r1166850

Vehicle Details & Analytics

Model details, depreciation, recalls, and current value for a specific vehicle.

GET /v1/details

requires authentication

Returns KBB research data for a model year: category, available years, other models from the make, specs, and trims. It also adds NHTSA crash-test ratings (safety_ratings) for up to three variants, or null when NHTSA has none.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/details'
params = {
  'year': '2025',
  'make': 'Chevrolet',
  'model': 'Silverado EV',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/details';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2025',
            'make' => 'Chevrolet',
            'model' => 'Silverado EV',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/details"
);

const params = {
    "year": "2025",
    "make": "Chevrolet",
    "model": "Silverado EV",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/details?year=2025&make=Chevrolet&model=Silverado+EV" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "year": "2023",
    "make": "mazda",
    "model": "cx-5",
    "total_trims": 8
  },
  "body": [
    {
      "vehicleId": 462025,
      "displayName": "2.5 S Sport Utility 4D",
      "combinedMpg": "26 MPG",
      "maxSeatingCapacity": 5,
      "horsepower": "187 @ 6000 RPM",
      "standardEngine": "4-Cyl, SKYACTIV-G, 2.5 Liter",
      "zeroToSixty": 8.9,
      "estimatedElectricRange": 0,
      "modelName": "CX-5",
      "modelMarketName": "CX-5",
      "isEv": false,
      "curbWeight": 3728,
      "batteryCapacity": 0,
      "topSpeed": 128,
      "chargeTime": 0,
      "torque": 186,
      "towingCapacity": 2000,
      "driveTrain": "AWD",
      "trunkOrCargoCapacity": 30,
      "evRange": null,
      "epaCity": 24,
      "epaHwy": 30,
      "epaMpgeCity": 0,
      "epaMpgeHwy": null,
      "epaCombined": 26,
      "epaMpgeCombined": 0,
      "fppPrice": 20200,
      "bodyStyle": "SUV"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/details

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Four-digit model year. Example: 2025

make required string

Make name. Spaces and punctuation are removed before the KBB lookup. Example: Chevrolet

model required string

Model name. Spaces and punctuation are removed before the KBB lookup. Example: Silverado EV

bodystyle optional string

optional Body style to narrow the KBB lookup, for example sedan or hatchback.

zipcode optional string

optional US ZIP code passed to KBB for regional data.

GET /v1/car-value

requires authentication

Returns KBB's current value for a vehicle at a given mileage, as either a trade-in value or private-party values by condition. Each value comes with a low and high range.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/car-value'
params = {
  'vehicle_id': '467716',
  'mileage': '50000',
  'zipcode': '45240',
  'priceType': 'private-party',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/car-value';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'vehicle_id' => '467716',
            'mileage' => '50000',
            'zipcode' => '45240',
            'priceType' => 'private-party',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/car-value"
);

const params = {
    "vehicle_id": "467716",
    "mileage": "50000",
    "zipcode": "45240",
    "priceType": "private-party",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/car-value?vehicle_id=467716&mileage=50000&zipcode=45240&priceType=private-party" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "vehicle_id": "467716",
        "zipcode": "73101",
        "price_type": "private-party",
        "mileage": "5000",
        "generated_at": "2026-06-16 02:15:59"
    },
    "body": {
        "excellent": {
            "value": 26880,
            "low": 24380,
            "high": 29380
        },
        "verygood": {
            "value": 26280,
            "low": 23780,
            "high": 28780
        },
        "good": {
            "value": 25680,
            "low": 23280,
            "high": 27980
        },
        "fair": {
            "value": 23980,
            "low": 21780,
            "high": 26180
        }
    }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/car-value

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
vehicle_id required string

KBB vehicle_id returned by /vin. vehicleId is accepted as an alias. Example: 467716

mileage required string

Current odometer reading in miles. Example: 50000

zipcode optional string

optional US ZIP code used for regional pricing. Defaults to 73101. Example: 45240

priceType optional string

optional Which value to return:

  • trade-in (default): one trade-in value with a low/high range
  • private-party: a value and range for each condition (excellent, verygood, good, fair) Example: private-party

GET /v1/reviews

requires authentication

Retrieve consumer reviews for a specific vehicle

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/reviews'
params = {
  'year': '2024',
  'make': 'mazda',
  'model': 'cx-5',
  'page': '1',
  'perPage': '6',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/reviews';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2024',
            'make' => 'mazda',
            'model' => 'cx-5',
            'page' => '1',
            'perPage' => '6',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/reviews"
);

const params = {
    "year": "2024",
    "make": "mazda",
    "model": "cx-5",
    "page": "1",
    "perPage": "6",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/reviews?year=2024&make=mazda&model=cx-5&page=1&perPage=6" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "year": "2023",
    "make": "mazda",
    "model": "cx-5",
    "total_reviews": 35,
    "total_pages": 4,
    "page": "2",
    "per_page": "10",
    "search_terms": [
      "safe"
    ]
  },
  "body": [
    {
      "id": 203986087,
      "nickname": "Bermo",
      "nickname_display": "Bermo",
      "location": null,
      "anonymous": false,
      "year": 2022,
      "model": "CX-5",
      "make": "MAZDA",
      "vehicle_id": 0,
      "title": "Mazda still builds real cars",
      "review_text": "While they try to ram electric cars down our throats, it’s gratifying to know that there is still a company that builds a real car. This car is amazing and the tech is fantastic. I ordered the NAV chip from Amazon. Don’t. A simple usb cable allows you to project your phone on the 10.4” display.\nI got the select version which is just above the base. I got leather seats, AWD, blind spot monitoring and cross traffic warning, adaptive cruise control, lane keep assist, heated seats, dual climate controls up front and leather wrapped steered no wheel and shifter all standard. \nThe styling is excellent, the interior reminds me of an Acura or a Lexus, and the car is definitely a drivers car. It handles beautifully and I am one of those people that hate CVT transmissions, so I love that Mazda gives you a REAL 6 speed automatic with sport mode. I got the non-turbo version because with the turbo, I wouldn’t have the self discipline not to thrash it every chance I got…and would probably start accumulating tickets as a result. Besides, I plan on having this car for a long time and turbochargers generally shorten the engine lifespan. \nAbout the only mod I decided on was the all weather floor mats…not weather-tech, but the custom leather measured ones for about half the price.\nAlloy wheels come standard. The car even sends me text messages if I forget to lock the doors. Also I love the auto start feature that lets me warm my car up on cold mornings.\nAbout the only criticism I have for the car is that the space behind the rear seat is not generous, but that is by design, not accident. A longer vehicle wouldn’t handle as brilliantly as this one does. No, I never plan to take it off road but for Chicago winters, it performs flawlessly.  I am getting about 26 mpg which I am happy with and the headlights are the brightest I have ever had. \nIf you want a vehicle to haul lots of stuff, the RAV4 or CRV would probably be a better fit. But if you want a real drivers car that makes very few compromises, has tons of standard features, safety tech like crazy, standard AWD and something you would be proud of every time you get to drive it, the CX-5 is the compact SUV for you as it was for me!",
      "ratings": {
        "overall": 5,
        "value": 5,
        "reliability": 5,
        "performance": 4,
        "styling": 5,
        "comfort": 5,
        "quality": 5
      },
      "recommend": true,
      "submission_date": "3/13/2022",
      "pros": "Drives like a sports car",
      "cons": "Conservative space behind the back seat",
      "feedback": {
        "positive_count": 2,
        "negative_count": 0,
        "total_count": 2,
        "positive_link": null,
        "negative_link": null
      },
      "photos": [],
      "staff_review": false,
      "incentivized": false,
      "ownership_status": "I own this car"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/reviews

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Example: 2024

make required string

Example: mazda

model required string

Example: cx-5

page optional integer

optional Page number for pagination Example: 1

perPage optional integer

optional Items per page Example: 6

bodystyle optional string

optional

vehicle_id optional string

optional Trim id from /trims.

trim optional string

optional Trim name

sort optional string

optional Sort by (e.g., "recent", "helpful")

filter optional string

optional Filter reviews

keyword optional string

optional Search keyword in reviews

GET /v1/rankings

requires authentication

Retrieve vehicle rankings across various categories

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/rankings'
params = {
  'year': '2024',
  'make': 'mazda',
  'model': 'cx-5',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/rankings';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'year' => '2024',
            'make' => 'mazda',
            'model' => 'cx-5',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/rankings"
);

const params = {
    "year": "2024",
    "make": "mazda",
    "model": "cx-5",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/rankings?year=2024&make=mazda&model=cx-5" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "year": "2023",
    "make": "mazda",
    "model": "cx-5"
  },
  "body": [
    {
      "details": {
        "displayName": "Horsepower",
        "columnHeader": "HP",
        "omnitureName": "rankhp",
        "value": "187"
      },
      "results": [
        {
          "position": 1,
          "value": "564",
          "manufacturer": "Fisker",
          "model": "Ocean",
          "year": 2024
        },
        { ... }
      ]
    },
    {
      "details": {
        "displayName": "MPG Combined",
        "columnHeader": "MPG",
        "omnitureName": "rankmpg",
        "value": "26"
      },
      "results": [
        {
          "position": 1,
          "value": "44",
          "manufacturer": "Dodge",
          "model": "Hornet",
          "year": 2024
        },
        { ... }
      ]
    },
    {
      "details": {
        "displayName": "Consumer Ratings",
        "columnHeader": "Rating",
        "omnitureName": "rankconsrat",
        "value": "4.4"
      },
      "results": [
        {
          "position": 1,
          "value": "4.7",
          "manufacturer": "Jeep",
          "model": "Compass",
          "year": 2024
        },
        { ... }
      ]
    }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/rankings

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
year required string

Example: 2024

make required string

Example: mazda

model required string

Example: cx-5

bodystyle optional string

optional

zipcode optional string

optional

GET /v1/depreciation

requires authentication

Returns KBB's year-by-year trade-in and private-party values for a vehicle, with each year flagged as past or projected. The summary gives the drop in trade-in value from the first year to the last, in dollars and as a percentage.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/depreciation'
params = {
  'vehicle_id': '475635',
  'mileage': '50000',
  'zipcode': '73101',
  'condition': 'verygood',
  'annualMileage': '12000',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/depreciation';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'vehicle_id' => '475635',
            'mileage' => '50000',
            'zipcode' => '73101',
            'condition' => 'verygood',
            'annualMileage' => '12000',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/depreciation"
);

const params = {
    "vehicle_id": "475635",
    "mileage": "50000",
    "zipcode": "73101",
    "condition": "verygood",
    "annualMileage": "12000",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/depreciation?vehicle_id=475635&mileage=50000&zipcode=73101&condition=verygood&annualMileage=12000" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "zipcode": "73101",
    "condition": "verygood",
    "mileage": 50000,
    "annual_mileage": 12000,
    "generated_at": "2026-06-16 02:30:47"
  },
  "body": {
    "summary": {
      "total_depreciation": 5810,
      "depreciation_percentage": 23.52,
      "total_years": 5
    },
    "depreciation_data": [
      {
        "year": 2024,
        "mileage": 26000,
        "trade_in_value": 24700,
        "private_party_value": 27690,
        "is_projected": false
      },
      {
        "year": 2025,
        "mileage": 38000,
        "trade_in_value": 23250,
        "private_party_value": 26250,
        "is_projected": false
      },
      {
        "year": 2026,
        "mileage": 50000,
        "trade_in_value": 21800,
        "private_party_value": 24800,
        "is_projected": false
      },
      { ... }
    ]
  }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/depreciation

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
vehicle_id required string

KBB vehicle_id returned by /vin. vehicleId is accepted as an alias. Example: 475635

mileage required integer

Current odometer reading in miles. Example: 50000

zipcode optional string

optional US ZIP code used for regional pricing. Defaults to 73101. Example: 73101

condition optional string

optional Vehicle condition: excellent, verygood, good, fair, or poor. Defaults to verygood. Example: verygood

annualMileage optional integer

optional Miles driven per year for the projection, 0 to 100000. Defaults to 12000. Example: 12000

GET /v1/recalls

requires authentication

Returns NHTSA recall campaigns for a vehicle, with the summary, affected component, consequence, remedy, report date, and campaign number. Identify the vehicle with year, make, and model; a VIN; or a vehicle_id. When more than one is sent, year, make, and model take precedence, then the VIN, then the id. If NHTSA has no match for a non-EPA id, KBB recall data is used and meta.source is kbb.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/recalls'
params = {
  'vehicle_id': '43515',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/recalls';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'vehicle_id' => '43515',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/recalls"
);

const params = {
    "vehicle_id": "43515",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/recalls?vehicle_id=43515" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
    "meta": {
        "version": "v1.0",
        "status": 200,
        "copywrite": "https://steadyapi.com",
        "vehicle_id": "43515",
        "year": "2021",
        "make": "Mercedes-Benz",
        "model": "C300",
        "source": "nhtsa",
        "total_recalls": 2
    },
    "body": {
        "recalls": [
            {
                "type": "Recall",
                "summary": "Mercedes-Benz USA, LLC (MBUSA) is recalling certain 2021 C300 Cabriolet, C43 AMG Cabriolet, C63 AMG Cabriolet, C63 AMG S Cabriolet, E450 Cabriolet, and E53 AMG Cabriolet vehicles.  The rear headrests may be incorrectly mounted to the seatbacks.",
                "component": "SEATS:MID/REAR ASSEMBLY:HEAD RESTRAINT",
                "consequence": "Incorrectly mounted headrests could move or detach from the seat during a crash, increasing the risk of injury.",
                "remedy": "Dealers will inspect the rear seatback guide bushings and replace them if necessary, free of charge.  Owner notification letters were mailed July 16, 2021.  Owners may contact MBUSA customer service at 1-800-367-6372.  MBUSA's number for this recall is 2021060010.",
                "report_date": "2021-05-28",
                "nhtsa_campaign_id": "21V406000",
                "manufacturer_recall_no": null,
                "potential_affected_units": null,
                "manufacture_dates": null
            },
            {
                "type": "Recall",
                "summary": "Mercedes-Benz USA, LLC (MBUSA) is recalling certain 2021 C-Class, E-Class, E-Class Coupe and Convertible, GLC, CLS, AMG GT 4-door Coupe and G-Class vehicles.  Please refer to MBUSA's recall report for specific vehicle model details.  A faulty electrical contact within the seat position switch may prevent the driver and passenger air bags and seat belt force limiters from properly activating during a crash.",
                "component": "SEATS",
                "consequence": "Air bags and seat belts that do not perform properly in a crash can increase the risk of injury.",
                "remedy": "MBUSA will notify owners, and dealers will replace the seat position switches, free of charge.  Owner letters were mailed May 21, 2021.  Owners may contact MBUSA customer service at 1-800-367-6372.  MBUSA's number for this recall is 2021040016.",
                "report_date": "2021-04-01",
                "nhtsa_campaign_id": "21V230000",
                "manufacturer_recall_no": null,
                "potential_affected_units": null,
                "manufacture_dates": null
            }
        ]
    }
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/recalls

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
vehicle_id optional string

optional EPA vehicle_id from /trims. A KBB vehicle_id from /vin also works. vehicleId is accepted as an alias. Example: 43515

year optional string

optional Four-digit model year. Send it with make and model when you have no vehicle_id or VIN.

make optional string

optional Make name, used with year and model.

model optional string

optional Model name, used with year and make.

vin optional string

optional 17-character VIN. It is decoded through NHTSA vPIC, and the decoded year, make, and model are matched to recalls.

Vehicle Commerce & Availability

Find dealers near a ZIP code for one make.

GET /v1/dealers

requires authentication

Returns KBB's dealer list for one make near a US ZIP code, with each dealer's name, address, phone, website, and distance in miles.

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/dealers'
params = {
  'zipcode': '60601',
  'make': 'Mazda',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/dealers';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'zipcode' => '60601',
            'make' => 'Mazda',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/dealers"
);

const params = {
    "zipcode": "60601",
    "make": "Mazda",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/dealers?zipcode=60601&make=Mazda" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "zipcode": "60601",
    "make": "mazda",
    "total_dealers": 11
  },
  "body": [
    {
      "StorefrontWebURL": "https://www.mazdaofchicagoland.com",
      "FranchisePhone": "224-307-8496",
      "UsedCarFranchiseId": 0,
      "ProfileId": 8001,
      "MakeId": 30,
      "FranchiseId": 7771155,
      "Distance": 11,
      "FranchiseZip": "60202",
      "FranchiseState": "IL",
      "FranchiseCity": "Evanston",
      "FranchiseAddress1": "1015 Chicago Avenue",
      "FranchiseName": "The Autobarn Mazda of Evanston",
      "VendorDealerId": "63784869",
      "FranchiseAndMake": "The Autobarn Mazda of Evanston",
      "PartnerFranchiseId": "63784869",
      "MakeName": "MAZDA",
      "PrimaryPhoto": "https://assets.cai-media-management.com/dealership/373d900a-7d32-4695-a2bf-2913b7387491.jpg"
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/dealers

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
zipcode required string

US ZIP code to search around. Example: 60601

make required string

Make name, for example Mazda or Land Rover. Example: Mazda

GET /v1/for-sale

requires authentication

Retrieve combined vehicle listings from Kelley Blue Book (KBB) and Carmax with normalized schema

Example request:
import requests
import json

url = 'https://api.steadyapi.com/v1/vehicles/for-sale'
params = {
  'make': 'mazda',
  'model': 'cx-5',
  'year': '2024',
  'zipcode': '73170',
  'source': 'kbb',
  'radius': '50',
  'page': '1',
  'per_page': '20',
  'sort_by': 'price',
  'sort_order': 'desc',
}
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()
$client = new \GuzzleHttp\Client();
$url = 'https://api.steadyapi.com/v1/vehicles/for-sale';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer YOUR_API_KEY',
        ],
        'query' => [
            'make' => 'mazda',
            'model' => 'cx-5',
            'year' => '2024',
            'zipcode' => '73170',
            'source' => 'kbb',
            'radius' => '50',
            'page' => '1',
            'per_page' => '20',
            'sort_by' => 'price',
            'sort_order' => 'desc',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://api.steadyapi.com/v1/vehicles/for-sale"
);

const params = {
    "make": "mazda",
    "model": "cx-5",
    "year": "2024",
    "zipcode": "73170",
    "source": "kbb",
    "radius": "50",
    "page": "1",
    "per_page": "20",
    "sort_by": "price",
    "sort_order": "desc",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
curl --request GET \
    --get "https://api.steadyapi.com/v1/vehicles/for-sale?make=mazda&model=cx-5&year=2024&zipcode=73170&source=kbb&radius=50&page=1&per_page=20&sort_by=price&sort_order=desc" \
    --header "Authorization: Bearer YOUR_API_KEY"

Example response (200, Success):


{
  "meta": {
    "version": "v1.0",
    "status": 200,
    "copywrite": "https://steadyapi.com",
    "make": "MAZDA",
    "model": "CX-5",
    "year": null,
    "zipcode": "73170",
    "search_radius": 50,
    "total_listings": 558,
    "total_pages": 28,
    "source": "carmax",
    "sorting": {
      "by": "relevance",
      "order": "asc"
    },
    "price_range": {
      "min": 12998,
      "max": 28998,
      "avg": 21898
    },
    "year_range": {
      "min": 2016,
      "max": 2025
    },
    "mileage_range": {
      "min": 14960,
      "max": 116814,
      "avg": 50235
    }
  },
  "body": [
    {
      "id": 28135196,
      "vin": "JM3KFACM7L0805890",
      "year": 2020,
      "make": "Mazda",
      "model": "CX-5",
      "trim": "Touring",
      "price": 22998,
      "mileage": 31522,
      "exterior_color": "Blue",
      "interior_color": "Black",
      "transmission": "Automatic",
      "drive_train": "Front Wheel Drive",
      "engine": "2.5L",
      "fuel_type": "Gas",
      "mpg_city": 25,
      "mpg_highway": 31,
      "body_style": "4D Sport Utility",
      "listing_type": "USED",
      "days_on_market": null,
      "is_new": false,
      "is_certified": false,
      "images": [
        {
          "url": "https://img2.carmax.com/assets/28135196/hero.jpg?width=400&height=300",
          "width": 400,
          "height": 300,
          "alt": "2020 Mazda CX-5"
        }
      ],
      "dealer": {
        "name": "Oklahoma City",
        "phone": "",
        "rating": 4.63157894736842,
        "review_count": 38,
        "location": {
          "address": "",
          "city": "Oklahoma City",
          "state": "OK",
          "zip": "",
          "distance": 19.1
        }
      },
      "price_details": {
        "sale_price": 22998,
        "msrp": null,
        "price_indicator": null,
        "price_valid_until": null
      },
      "features": [
        "Alloy Wheels",
        "Rear Defroster",
        "Power Mirrors",
        ...
      ],
      "vhr_preview": [],
      "source_url": "https://www.carmax.com/car/28135196",
      "stock_number": 28135196
    },
    { ... }
  ]
}
 

Example response (401, Unauthenticated):


{
    "message": "Unauthenticated."
}
 

Example response (404, Not Found):


{
    "success": false,
    "message": "Resource Not Found"
}
 

Example response (422, Error Validations):


{
    "message": "The ticker field is required.",
    "errors": {
        "ticker": [
            "The ticker field is required."
        ]
    }
}
 

Request      

GET v1/vehicles/for-sale

Headers

Authorization Bearer YOUR_API_KEY

Query Parameters

Parameter Type Description
make required string

Example: mazda

model required string

Example: cx-5

year optional string

optional Example: 2024

zipcode optional string

optional Example: 73170

source optional string

optional Options: carmax or kbb (default: kbb) Example: kbb

radius optional integer

optional Search radius in miles (default: 50) Example: 50

min_price optional integer

optional Minimum price

max_price optional integer

optional Maximum price

min_mileage optional integer

optional Minimum mileage

max_mileage optional integer

optional Maximum mileage

page optional integer

optional Page number (default: 1) Example: 1

per_page optional integer

optional Items per page (default: 20, max: 50) Example: 20

sort_by optional string

optional Sorting fields: relevance, price, mileage, year, distance, date_listed (default: relevance) Example: price

sort_order optional string

optional Sorting order (default: asc) Example: desc