🚗 AutoHub API
AutoHub vehicle API for US vehicle specs, values, recalls, and dealers.
- Make, model, and trim lookup, plus VIN decoding
- Model details, depreciation, and recalls
- Trade-in and private-party values
- Dealers near a ZIP code
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
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."
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.