Kelley Blue Book car values
Kelley Blue Book values for one car at a mileage, condition and ZIP: the trade-in value with its range, private-party values (with ranges) for excellent, very good, good and fair condition, the dates they are valid for, and a forecast of private-party and trade-in values for the coming months. Identify the car by vehicle_id (from /kbb/v1/model trims) or by vin.
Every response includes credits_used: the credits this call cost.
Part of the Kelley Blue Book API: 6 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
vehicle_id | string | Kelley Blue Book vehicle id (trims[].vehicle_id in /kbb/v1/model). Example: 445266 |
vin | string | 17-character VIN, used when vehicle_id is not given. |
mileagerequired | integer | Odometer miles. Example: 50000 |
condition | excellent | very-good | good | fair | Condition for the trade-in value and the forecast. |
zip | string | ZIP code (default 90210). |
annual_mileage | integer | Miles per year for the forecast (default 12000). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/kbb/v1/values?vehicle_id=445266&mileage=50000" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/kbb/v1/values",
params={"vehicle_id": "445266", "mileage": "50000"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/kbb/v1/values");
url.searchParams.set("vehicle_id", "445266");
url.searchParams.set("mileage", "50000");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"vehicle_id": 445266,"vehicle": null,"zip": "90210","mileage": 50000,"condition": "good","trade_in": {"value": 15690,"low": 14740,"high": 16640},"private_party": {"excellent": {"value": 19850,"low": 18900,"high": 20800},"very_good": {"value": 19350,"low": 18450,"high": 20250},"good": {"value": 18750,"low": 17900,"high": 19650},"fair": {"value": 17350,"low": 16550,"high": 18150}},"valid": {"from": "2026-11-06T00:00:00Z","to": "2026-11-06T00:00:00Z"},"forecast": {"annual_mileage": 12000,"months": [{"month": "Today","months_ahead": 0,"projected": false,"odometer": 50000,"private_party_value": 18750,"trade_in_value": 15690}]},"cached": false,"credits_used": 1}