v1

latestOpenAPI 3.0.02026-07-147195292.0 KB

Cars History API

Get a cars online listing history

The history API returns online listing history for a car identified by its VRM. History listings are sorted in the descending order of the listing date / last seen date

get/history/car/uk/{vrm}

Path parameters

vrmstring string required

The VRM to identify the car.

Query parameters

api_keystring

The API Authentication Key. Mandatory with all API calls.

pagenumber

Page number to fetch the results for the given criteria. Default is 1.

include_duplicatesboolean

Flag to indicate whether to include duplicate historical records as well in the response

sort_order'asc' | 'desc' | 'ASC' | 'DESC' string

Sort order - asc or desc. Default sort order is asc

Response

Online listing history for the given vrm

carfax_1_ownerboolean

Flag to indicate whether listing is carfax_1_owner

carfax_clean_titleboolean

Flag to indicate whether listing is carfax_clean_title

citystring

City of the listing

data_sourcestring

Data source of the listing

dealer_idinteger

Unique MC assigned dealers id for the listing

dominteger

Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car

dom_180integer

Days on Market value for the car based on current and last 6 month listings found in the Marketcheck database for this car

dom_activeinteger

Days on Market value for the car based on current and last 30 days listings found in the Marketcheck database for this car

exterior_colorstring

Exterior color of the car

first_seen_atinteger

Listing first seen at first scraped timestamp

first_seen_at_datestring

Listing first seen at first scraped date

headingstring

Listing title as displayed on the source website

idstring

Unique identifier representing a specific listing from the Marketcheck database

interior_colorstring

Interior color of the car

inventory_typestring

Inventory type of car

is_certifiedinteger

Certified car

is_searchablestring

Flag to indicate listing is marked searchable or not

last_seen_atinteger

Listing last seen at (most recent) timestamp

last_seen_at_datestring

Listing last seen at (most recent) date

latitudestring

Latitude of the listing

longitudestring

Longitude of the listing

milesinteger

Odometer reading / reported miles usage for the car

msrpinteger

MSRP for the car

priceinteger

Asking price for the car

ref_milesstring

Last Odometer reading / reported miles usage for the car. If the asking miles value is not or is available then the last_miles could perhaps be used. last_miles is the miles for the car listed on the source website as of last_miles_dt date

ref_miles_dtinteger

The date at which the last miles was reported online. This is earlier to last_seen_date

ref_pricestring

Last reported price for the car. If the asking price value is not or is available then the last_price could perhaps be used. last_price is the price for the car listed on the source website as of last_price_dt date

ref_price_dtinteger

The date at which the last price was reported online. This is earlier to last_seen_date

scraped_atinteger

Listing last seen at date timestamp

scraped_at_datestring

Listing last seen at date

seller_namestring

Seller name of the listing from the Marketcheck database

seller_name_ostring

Seller name of the listing from the Marketcheck database

seller_typestring

Seller type for the car

sourcestring

Source domain of the listing

statestring

State of the listing

status_dateinteger

Timestamp of status date

stock_nostring

Stock number of car in dealers inventory

streetstring

Street of the listing

trim_rstring

Trim of the car

vdp_urlstring

Vehicle Details Page url of the specific car

vinstring

VIN for the car

zipstring

Zip of the listing