Kelley Blue Book car values

GET https://api.api.sh/kbb/v1/values
1 credit / call automotive try it in the playground →

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

nametypedescription
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"

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}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.