Marketcheck aggregates and normalises data from over 10,000 dealers with over 600,000 listings updated daily to deliver almost 100% coverage of the retail market.
Leverage historic data to provide vital intelligence for remarketing, insurance investigations, competitor analysis and vehicle history checks.
Key Features
Historic Listings
January 2022 to date
Duration
First and last seen dates for every listing
Retail Price
Discover the advertised price history
Dealer sourced
End to end coverage from listing to sale
Mileage
Verify mileage history
Seller Details
Discover previous selling dealer
Sample Response
V2
Documentation
Introduction
This endpoint provides all the historic listings for a vehicle since 1st January 2021 including the last advertised price, advertised mileage and seller's information.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/marketcheck/historiclistingsfromvrm?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/marketcheck/historiclistingsfromvrm?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
Sample Response
{
"success": true,
"result": {
"historic_listings": [
{
"advert_id": "X1234",
"advertised_price_gbp": 12345.67,
"mileage_observed": 12345,
"vehicle_details_page_url": "http://www.advert.com/advert=12345",
"seller_type": "dealer",
"ownership_condition": "new",
"last_seen_date": "2023-02-21",
"first_seen_date": "2023-01-15",
"source_url": "www.advert.com",
"seller_name": "ACME Motors",
"city": "London",
"post_code": "AB1 2CD"
}
],
"error": "If there is an error the message would go here"
}
}Response Parameters
success
e.g. true
Whether the api call was successful
advert_id
e.g. X1234
Advert Id
advertised_price_gbp
e.g. 12345.67
Advertised vehicle price
mileage_observed
e.g. 12345
Vehicle odometer reading
vehicle_details_page_url
e.g. http://www.advert.com/advert=12345
Url to the vehicle on the source website
seller_type
e.g. dealer
e.g. dealer
ownership_condition
e.g. new
e.g. new or used
last_seen_date
e.g. 2023-02-21
Last seen date for the current listing
first_seen_date
e.g. 2023-01-15
First seen date for the current listing
source_url
e.g. www.advert.com
Website address
seller_name
e.g. ACME Motors
Seller name
city
e.g. London
City
post_code
e.g. AB1 2CD
The location of the stock vehicle used as the centre of the search.
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call
Status Codes
200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com