Marketcheck APIs
  1. Cars History API
Marketcheck APIs
  • Car Search
    • Get dealers active inventory
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Gets active car listings for the given search criteria
      GET
    • Gets active auction car listings for the given search criteria
      GET
    • API for auto-completion of inputs
      GET
    • Gets active private party car listings for the given search criteria
      GET
    • Gets Recent car listings for the given search criteria
      GET
    • Gets active car listings in UK for the given search criteria
      GET
    • Gets Recent UK car listings for the given search criteria
      GET
  • Recall Search
    • Recall info by vin
      GET
  • CRM Cleanse API
    • CRM check of a particular vin
      GET
  • Dealer API
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
  • VIN Decoder API
    • EPI VIN Decoder
    • NeoVIN Decoder
    • VIN Decoder
    • API for auto-completion of inputs based on taxonomy
    • API for getting terms from taxonomy
  • Cars History API
    • Get a cars online listing history
      GET
    • Get a cars online listing history
      GET
  • Car Cached Image
    • Fetch cached image
  • Heavy Equipment Search
    • Heavy equipment listing by id
    • Long text Heavy equipment Listings attributes for Listing with the given id
    • Listing media by id
    • Gets active heavy equipment listings for the given search criteria
    • API for auto-completion of inputs
  • Motorcycle Search
    • Motorcycle listing by id
    • Long text Motorcycle Listings attributes for Listing with the given id
    • Motorcycle listing media by id
    • Gets active motorcycle listings for the given search criteria
    • API for auto-completion of inputs
  • RV Search
    • RV listing by id
    • Long text RV Listings attributes for Listing with the given id
    • Listing media by id
    • RV listing by id
    • Long text RV Listings attributes for Listing with the given id
    • Listing media by id
    • Gets active RV listings for the given search criteria
    • API for auto-completion of inputs
    • Gets active RV listings for the given search criteria
  • Cars Market API
    • Market Days Supply
    • Get make model wise top 50 popular cars on national, state, city level
    • Predict car price based on it's specifications
    • Predict fare value of car for UK based on YMMT & miles
    • Predict car price for UK based on it's specifications
    • Get sales count by make, model, year, trim or taxonomy vin
    • Price, Miles and Days on Market stats
  • Rank Car Listings
    • Compute relative rank for car listings.
    • Compute relative rank for car listings.
  • OEM Incentive Search
    • Gets oem incentive listings for the given search criteria
  • client filters
    • get client filters
    • set client filters
  1. Cars History API

Get a cars online listing history

GET
/history/car/{vin}
Cars History API
The history API returns online listing history for a car identified by its VIN. History listings are sorted in the descending order of the listing date / last seen date
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marketcheck-prod.apigee.net/v2/history/car/'
Response Response Example
200 - Example 1
[
    {
        "carfax_1_owner": true,
        "carfax_clean_title": true,
        "city": "string",
        "data_source": "string",
        "dealer_id": 0,
        "dom": 0,
        "dom_180": 0,
        "dom_active": 0,
        "exterior_color": "string",
        "financing_options": [
            {
                "down_payment": 0,
                "down_payment_percentage": 0,
                "estimated_monthly_payment": 0,
                "loan_apr": 0,
                "loan_term": 0
            }
        ],
        "first_seen_at": 0,
        "first_seen_at_date": "string",
        "heading": "string",
        "id": "string",
        "interior_color": "string",
        "inventory_type": "string",
        "is_certified": 0,
        "is_searchable": "string",
        "last_seen_at": 0,
        "last_seen_at_date": "string",
        "latitude": "string",
        "leasing_options": [
            {
                "down_payment": 0,
                "estimated_monthly_payment": 0,
                "lease_term": 0
            }
        ],
        "longitude": "string",
        "miles": 0,
        "msrp": 0,
        "price": 0,
        "ref_miles": "string",
        "ref_miles_dt": 0,
        "ref_price": "string",
        "ref_price_dt": 0,
        "scraped_at": 0,
        "scraped_at_date": "string",
        "seller_name": "string",
        "seller_name_o": "string",
        "seller_type": "string",
        "source": "string",
        "state": "string",
        "status_date": 0,
        "stock_no": "string",
        "street": "string",
        "trim_r": "string",
        "vdp_url": "string",
        "vin": "string",
        "zip": "string"
    }
]

Request

Path Params
vin
string 
required
The VIN to identify the car. Must be a valid 17 char VIN
Query Params
api_key
string 
optional
The API Authentication Key. Mandatory with all API calls.
fields
string 
optional
List of fields to fetch, in case the default fields list in the response is to be trimmed down
page
number 
optional
Page number to fetch the results for the given criteria. Default is 1.
include_duplicates
string 
optional
Flag to indicate whether to include duplicate historical records as well in the response
sort_order
string 
optional
Sort order - asc or desc. Default sort order is asc

Responses

🟢200Online listing history for the given vin
application/json
Body
array of:
carfax_1_owner
boolean 
optional
Flag to indicate whether listing is carfax_1_owner
carfax_clean_title
boolean 
optional
Flag to indicate whether listing is carfax_clean_title
city
string 
optional
City of the listing
data_source
string 
optional
Data source of the listing
dealer_id
integer 
optional
Unique MC assigned dealers id for the listing
dom
integer 
optional
Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car
dom_180
integer 
optional
Days on Market value for the car based on current and last 6 month listings found in the Marketcheck database for this car
dom_active
integer 
optional
Days on Market value for the car based on current and last 30 days listings found in the Marketcheck database for this car
exterior_color
string 
optional
Exterior color of the car
financing_options
array[object (ListingFinance) {5}] 
optional
Array of all finance offers for this listing
down_payment
number <double>
optional
Down payment for this finance offer
down_payment_percentage
number <double>
optional
down payment percentage for this finance offer
estimated_monthly_payment
number <double>
optional
estimated monthly payment for this finance offer
loan_apr
number <double>
optional
Loan APR for this finance offer
loan_term
integer 
optional
Loan term for this finance offer
first_seen_at
integer 
optional
Listing first seen at first scraped timestamp
first_seen_at_date
string 
optional
Listing first seen at first scraped date
heading
string 
optional
Listing title as displayed on the source website
id
string 
optional
Unique identifier representing a specific listing from the Marketcheck database
interior_color
string 
optional
Interior color of the car
inventory_type
string 
optional
Inventory type of car
is_certified
integer 
optional
Certified car
is_searchable
string 
optional
Flag to indicate listing is marked searchable or not
last_seen_at
integer 
optional
Listing last seen at (most recent) timestamp
last_seen_at_date
string 
optional
Listing last seen at (most recent) date
latitude
string 
optional
Latitude of the listing
leasing_options
array[object (ListingLease) {3}] 
optional
Array of all finance offers for this listing
down_payment
number <double>
optional
Down payment for this lease offer
estimated_monthly_payment
number <double>
optional
estimated monthly payment for this lease offer
lease_term
integer 
optional
Lease term for this lease offer
longitude
string 
optional
Longitude of the listing
miles
integer 
optional
Odometer reading / reported miles usage for the car
msrp
integer 
optional
MSRP for the car
price
integer 
optional
Asking price for the car
ref_miles
string 
optional
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_dt
integer 
optional
The date at which the last miles was reported online. This is earlier to last_seen_date
ref_price
string 
optional
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_dt
integer 
optional
The date at which the last price was reported online. This is earlier to last_seen_date
scraped_at
integer 
optional
Listing last seen at date timestamp
scraped_at_date
string 
optional
Listing last seen at date
seller_name
string 
optional
Seller name of the listing from the Marketcheck database
seller_name_o
string 
optional
Seller name of the listing from the Marketcheck database
seller_type
string 
optional
Seller type for the car
source
string 
optional
Source domain of the listing
state
string 
optional
State of the listing
status_date
integer 
optional
Timestamp of status date
stock_no
string 
optional
Stock number of car in dealers inventory
street
string 
optional
Street of the listing
trim_r
string 
optional
Trim of the car
vdp_url
string 
optional
Vehicle Details Page url of the specific car
vin
string 
optional
VIN for the car
zip
string 
optional
Zip of the listing
🔴500Error
Modified at 2023-08-15 07:36:55
Previous
Get a cars online listing history
Next
Fetch cached image
Built with