---
title: "Get a vehicle listing from dataset"
method: GET
path: "/datasets/vehicle-listings/items/{id}"
tags: ["Datasets"]
---

# Get a vehicle listing from dataset

`GET /datasets/vehicle-listings/items/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/vehicle-listings/items/{id}`
- Auth: API key in header `x-api-key`

Returns one vehicle listing from the dataset by `id`, formatted `<source>:<source_listing_id>`, such as `carmax:28187774`. The record has VIN, year, make, model, trim, mileage, price and previous price, colours, drivetrain, seller, location and first and last seen times. An unknown id returns 404.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsVehicleListingResponseDoc
  - `code` integer
  - `data` EsVehicleListingRecord
    - `accident_count` integer: AccidentCount/OwnerCount come from a source's vehicle-history detail (CarMax's own /vehicle/{stock_number} History block as of 2026-08-20; reserved for other sources with an equivalent field). Pointers, not plain ints: 0 is a real, safety-relevant claim ("confirmed zero accidents") distinct from "we haven't enriched this listing yet". Populated only for a bounded number of newly-discovered listings per crawl pass, not backfilled for the whole catalog at once.
    - `body_style` string
    - `city` string
    - `crawled_at` string
    - `drive_type` string
    - `engine` string
    - `exterior_color` string
    - `first_seen_at` string: FirstSeenAt/LastSeenAt are our own crawl-observed dates, not upstream fields -- see the type doc comment. Both are RFC3339.
    - `fuel_type` string
    - `id` string
    - `image_url` string
    - `interior_color` string
    - `is_price_reduced` boolean
    - `last_seen_at` string
    - `latitude` number
    - `longitude` number
    - `make` string
    - `mileage` integer
    - `model` string
    - `owner_count` integer
    - `previous_price` number
    - `price` number
    - `run_id` string
    - `schema_version` integer
    - `seller_name` string
    - `seller_type` string: SellerType is "retailer" for CarMax (its own inventory, not a dealer network) and reserved "dealer"/"private" values for future sources that aggregate third-party sellers (Autotrader, Cars.com).
    - `source` string
    - `source_listing_id` string
    - `state` string
    - `transmission` string
    - `trim` string
    - `url` string
    - `vin` string
    - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)