Endpoint Playground

Try the CarMax vehicle listing detail API

Returns a CarMax vehicle listing: full vehicle spec (make, model, trim, mileage, colors, engine, transmission, fuel economy, pricing), equipment features, labeled specifications, warranty coverage, accident/owner history, and CarMax's return guarantee terms.

What a live request returned

14 Oct 2026: 16 features; 1 fields had a value in every checked item.

Observed request: GET /carmax/vehicle/28631545
Fields with a value in every checked item: name

Sample value profiles: name: “ABS Brakes” and 15 other values.

Request: GET /carmax/vehicle/{stock_number}
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.9%, median 6.52 s
Monitored request: GET /carmax/vehicle/28631545

CarMax vehicle listing detail API documentation CarMax platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carmax/vehicle/28187774' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
stock_number (path)	string	Yes	28187774	CarMax stock number, the numeric path segment of a /car/{stock_number} URL
store_id	string	No		Optional CarMax store id for pricing/transfer-fee display context. Defaults to a fixed CarMax store when omitted

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stock_number": 28187774,
    "vin": "1FMJK1K89REA27006",
    "year": 2024,
    "make": "Ford",
    "model": "Expedition Max",
    "trim": "Limited",
    "body": "4D Sport Utility",
    "mileage": 41406,
    "exterior_color": "Black",
    "interior_color": "Tan",
    "engine": "3.5L",
    "transmission": {
      "type": "Automatic",
      "display": "Automatic"
    },
    "drive_train_type": "Rear Wheel Drive",
    "fuel": {
      "type": "Gas"
    },
    "efficiency": {
      "mpg_city": 17,
      "mpg_highway": 23
    },
    "price_info": {
      "price": 45998,
      "is_price_reduced": true,
      "previous_price": 46998
    },
    "store": {
      "id": 7124,
      "name": "Canoga Park",
      "state": "CA",
      "latitude": 34.21972,
      "longitude": -118.59617
    },
    "cylinders": 6,
    "horsepower": 400,
    "engine_torque_lb_ft": 480,
    "specs": [
      {
        "name": "Transmission",
        "display_value": "Automatic"
      },
      {
        "name": "EPA estimated mileage",
        "display_value": "17/23 mpg"
      }
    ],
    "features": [
      {
        "name": "Panoramic Sunroof"
      },
      {
        "name": "Leather Seats"
      }
    ],
    "warranties": [
      {
        "type": "Basic",
        "years": 3,
        "miles": 36000
      },
      {
        "type": "Powertrain",
        "years": 5,
        "miles": 60000
      }
    ],
    "history": {
      "accident_count": 1,
      "owner_count": 1,
      "prior_uses": [
        "Leased Vehicle",
        "Rental"
      ]
    },
    "vehicle_guarantee": {
      "title": "Love your car guarantee",
      "description": "30-day money back returns (up to 1,500 miles)",
      "disclaimer": "Take 24 hours to decide. You can then purchase or return the car..."
    },
    "url": "https://www.carmax.com/car/28187774",
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/vehicles/28187774"
  }
}

More CarMax endpoints

Search CarMax vehicle listings Get CarMax search autocomplete suggestions Get CarMax's "shop by brand" make taxonomy Get CarMax store (physical location) detail Search CarMax store (physical location) locations Get CarMax "similar vehicles" recommendations for a listing

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestcarmax.VehicleResponseCarMax

GET /carmax/vehicle/{stock_number}

Get CarMax vehicle listing detail

Response behavior

- `stock_number` must be numeric; a non-numeric value returns `400` before any upstream request is made. - A stock number that is well-formed but no longer exists (sold, removed, or never existed) returns `404`. - **Hybrid sourcing**: most fields come from CarMax's mobile-app API. Three things it doesn't expose are backfilled from the website's own page instead — `history` (accident/owner counts), `warranties` (structured coverage terms), and `body`/`fuel.type`. If that backfill fetch fails for any reason, the response is still returned successfully with everything the mobile API provided; `history` is **omitted entirely** in that case (not present as `null` or a zero-valued object) rather than showing a misleading `accident_count: 0`/`owner_count: 0` that would read as "verified clean" when it's actually "unknown". `warranties` similarly comes back as an empty list, and `body`/`fuel.type` as empty strings, in that scenario. - `vehicle_guarantee` (CarMax's return-policy terms) and exact `horsepower`/`cylinders`/`engine_torque_lb_ft` figures are only available via the mobile API and have no website-scrape equivalent to fall back to. - `specs` entries from the mobile API don't carry a `category` (CarMax's mobile response is a flat name/value list, unlike the website's categorized spec groups) — `category` is empty in that case.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

stock_number

requiredstring

CarMax stock number, the numeric path segment of a /car/{stock_number} URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stock_number": 28187774,
    "vin": "1FMJK1K89REA27006",
    "year": 2024,
    "make": "Ford",
    "model": "Expedition Max",
    "trim": "Limited",
    "body": "4D Sport Utility",
    "mileage": 41406,
    "exterior_color": "Black",
    "interior_color": "Tan",
    "engine": "3.5L",
    "transmission": {
      "type": "Automatic",
      "display": "Automatic"
    },
    "drive_train_type": "Rear Wheel Drive",
    "fuel": {
      "type": "Gas"
    },
    "efficiency": {
      "mpg_city": 17,
      "mpg_highway": 23
    },
    "price_info": {
      "price": 45998,
      "is_price_reduced": true,
      "previous_price": 46998
    },
    "store": {
      "id": 7124,
      "name": "Canoga Park",
      "state": "CA",
      "latitude": 34.21972,
      "longitude": -118.59617
    },
    "cylinders": 6,
    "horsepower": 400,
    "engine_torque_lb_ft": 480,
    "specs": [
      {
        "name": "Transmission",
        "display_value": "Automatic"
      },
      {
        "name": "EPA estimated mileage",
        "display_value": "17/23 mpg"
      }
    ],
    "features": [
      {
        "name": "Panoramic Sunroof"
      },
      {
        "name": "Leather Seats"
      }
    ],
    "warranties": [
      {
        "type": "Basic",
        "years": 3,
        "miles": 36000
      },
      {
        "type": "Powertrain",
        "years": 5,
        "miles": 60000
      }
    ],
    "history": {
      "accident_count": 1,
      "owner_count": 1,
      "prior_uses": [
        "Leased Vehicle",
        "Rental"
      ]
    },
    "vehicle_guarantee": {
      "title": "Love your car guarantee",
      "description": "30-day money back returns (up to 1,500 miles)",
      "disclaimer": "Take 24 hours to decide. You can then purchase or return the car..."
    },
    "url": "https://www.carmax.com/car/28187774",
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/vehicles/28187774"
  }
}

Try the CarMax vehicle listing detail API

What a live request returned

14 Oct 2026: 16 features; 1 fields had a value in every checked item.

Observed request: GET /carmax/vehicle/28631545
Fields with a value in every checked item: name

Sample value profiles: name: “ABS Brakes” and 15 other values.

Request: GET /carmax/vehicle/{stock_number}
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.9%, median 6.52 s
Monitored request: GET /carmax/vehicle/28631545

CarMax vehicle listing detail API documentation CarMax platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carmax/vehicle/28187774' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
stock_number (path)	string	Yes	28187774	CarMax stock number, the numeric path segment of a /car/{stock_number} URL
store_id	string	No		Optional CarMax store id for pricing/transfer-fee display context. Defaults to a fixed CarMax store when omitted

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stock_number": 28187774,
    "vin": "1FMJK1K89REA27006",
    "year": 2024,
    "make": "Ford",
    "model": "Expedition Max",
    "trim": "Limited",
    "body": "4D Sport Utility",
    "mileage": 41406,
    "exterior_color": "Black",
    "interior_color": "Tan",
    "engine": "3.5L",
    "transmission": {
      "type": "Automatic",
      "display": "Automatic"
    },
    "drive_train_type": "Rear Wheel Drive",
    "fuel": {
      "type": "Gas"
    },
    "efficiency": {
      "mpg_city": 17,
      "mpg_highway": 23
    },
    "price_info": {
      "price": 45998,
      "is_price_reduced": true,
      "previous_price": 46998
    },
    "store": {
      "id": 7124,
      "name": "Canoga Park",
      "state": "CA",
      "latitude": 34.21972,
      "longitude": -118.59617
    },
    "cylinders": 6,
    "horsepower": 400,
    "engine_torque_lb_ft": 480,
    "specs": [
      {
        "name": "Transmission",
        "display_value": "Automatic"
      },
      {
        "name": "EPA estimated mileage",
        "display_value": "17/23 mpg"
      }
    ],
    "features": [
      {
        "name": "Panoramic Sunroof"
      },
      {
        "name": "Leather Seats"
      }
    ],
    "warranties": [
      {
        "type": "Basic",
        "years": 3,
        "miles": 36000
      },
      {
        "type": "Powertrain",
        "years": 5,
        "miles": 60000
      }
    ],
    "history": {
      "accident_count": 1,
      "owner_count": 1,
      "prior_uses": [
        "Leased Vehicle",
        "Rental"
      ]
    },
    "vehicle_guarantee": {
      "title": "Love your car guarantee",
      "description": "30-day money back returns (up to 1,500 miles)",
      "disclaimer": "Take 24 hours to decide. You can then purchase or return the car..."
    },
    "url": "https://www.carmax.com/car/28187774",
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/vehicles/28187774"
  }
}

Get CarMax vehicle listing detail

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "stock_number": 28187774, "vin": "1FMJK1K89REA27006", "year": 2024, "make": "Ford", "model": "Expedition Max", "trim": "Limited", "body": "4D Sport Utility", "mileage": 41406, "exterior_color": "Black", "interior_color": "Tan", "engine": "3.5L", "transmission": { "type": "Automatic", "display": "Automatic" }, "drive_train_type": "Rear Wheel Drive", "fuel": { "type": "Gas" }, "efficiency": { "mpg_city": 17, "mpg_highway": 23 }, "price_info": { "price": 45998, "is_price_reduced": true, "previous_price": 46998 }, "store": { "id": 7124, "name": "Canoga Park", "state": "CA", "latitude": 34.21972, "longitude": -118.59617 }, "cylinders": 6, "horsepower": 400, "engine_torque_lb_ft": 480, "specs": [ { "name": "Transmission", "display_value": "Automatic" }, { "name": "EPA estimated mileage", "display_value": "17/23 mpg" } ], "features": [ { "name": "Panoramic Sunroof" }, { "name": "Leather Seats" } ], "warranties": [ { "type": "Basic", "years": 3, "miles": 36000 }, { "type": "Powertrain", "years": 5, "miles": 60000 } ], "history": { "accident_count": 1, "owner_count": 1, "prior_uses": [ "Leased Vehicle", "Rental" ] }, "vehicle_guarantee": { "title": "Love your car guarantee", "description": "30-day money back returns (up to 1,500 miles)", "disclaimer": "Take 24 hours to decide. You can then purchase or return the car..." }, "url": "https://www.carmax.com/car/28187774", "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/vehicles/28187774" } }