Search CarMax's national used-car inventory. Filter by make and model path segments, year range, mileage range, price range, sort order, and ZIP code. Returns 48 listing cards per page with stock number, VIN, price, mileage, store, rating, features, colors, transmission, engine specs, MPG, and the hero image URL. Page 1 only; deep pagination is not available.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
7 optional filters available.
string
Optional
Make filter as a path segment, e.g. toyota.
example
string
Optional
Model filter as a path segment, e.g. camry.
example
string
Optional
Model year range, e.g. 2020-2022.
example
string
Optional
Mileage range in miles, e.g. 0-50000.
example
string
Optional
Price range in USD, e.g. 10000-20000.
example
string
Optional
bestmatch, distance-asc, price-asc, price-desc, mileage-asc, mileage-desc, year-desc, year-asc, newarrival.
relevance
string
Optional
US ZIP code for distance sorting, e.g. 10001.
example
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A public parameter is invalid. This response is not billable.
HTTP 503
CarMax did not return usable data for this request. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.