v1
latestOpenAPI 3.0.02026-07-147195292.0 KBMarket Days Supply
Get the basic information on specifications for a car identified by a valid VIN
Query parameters
The API Authentication Key. Mandatory with all API calls.
VIN to decode
Exact parameter
Latitude component of location
Longitude component of location
Radius around the search location (Unit - Miles)
To filter listing on ZIP around which they are listed
To filter listing on msa code in which they are listed
Debug parameter
To fetch sold vins
To filter listing on Country in which they are listed
To filter listing on State in which they are listed
To filter listing on City in which they are listed
Comma separated list of Year, Make, Model, Trim combinations. Each combination needs to have the year,make,model, trim values separated by a pipe '|' character in the form year|make|model|trim. e.g. 2010|Audi|A5,2014|Nissan|Sentra|S 6MT,|Honda|City| You could just provide strings of the form - 'year|make||' or 'year|make|model' or '|make|model|' combinations. Individual year / make / model filters provied with the API calls will take precedence over the Year, Make, Model, Trim combinations. The Make, Model, Trim values must be valid values as per the Marketcheck Vin Decoder. If you are using a separate vin decoder then look at using the 'vins' or 'taxonomy_vins' parameter to the search api instead the year|make|model|trim combinations.
Car type. Allowed values are - new / used / certified
Search listings with exact lease term, or inside a range with min and max seperated by a dash like lease_term=30-60
Search listings with exact down payment in lease offers, or inside a range with min and max seperated by a dash like lease_down_payment=30-60
Search listings with lease offers exactly matching Estimated Monthly Payment(EMI), or inside a range with min and max seperated by a dash like lease_emp=30-60
Search listings with exact finance loan term, or inside a range with min and max seperated by a dash like finance_loan_term=30-60
Search listings with finance offers exactly matching loans Annual Percentage Rate, or inside a range with min and max seperated by a dash like finance_loan_apr=30-60
Search listings with finance offers exactly matching Estimated Monthly Payment(EMI), or inside a range with min and max seperated by a dash like finance_emp=30-60
Search listings with exact down payment in finance offers, or inside a range with min and max seperated by a dash like finance_down_payment=30-60
Search listings with exact down payment percentage in finance offers, or inside a range with min and max seperated by a dash like finance_down_payment_per=30-60
Indicates whether car has had only one owner or not
Indicates whether car has clean ownership records
To filter listing on their year
To filter listings on their make
To filter listings on their model
To filter listing on their trim
Dealer id to filter the listings.
To filter listing on their source
To filter listing on their body type
Body subtype to filter the listings on. Valid filter values are those that our Search facets API returns for unique body subtypes. You can pass in multiple body subtype values comma separated
To filter listing on their vehicle type
To filter listing on their cylinders
To filter listing on their transmission
Doors to filter the cars on. Valid filter values are those that our Search facets API returns for unique doors. You can pass in multiple doors values comma separated
To filter listing on their drivetrain
Exterior color to match. Valid filter values are those that our Search facets API returns for unique exterior colors. You can pass in multiple exterior color values comma separated
Interior color to match. Valid filter values are those that our Search facets API returns for unique interior colors. You can pass in multiple interior color values comma separated
Base exterior color to match. Valid filter values are those that our Search facets API returns for unique base exterior colors. You can pass in multiple base interior color values comma separated
Base interior color to match. Valid filter values are those that our Search facets API returns for unique base interior colors. You can pass in multiple base interior color values comma separated
To filter listing on their engine
Engine Size to match. Valid filter values are those that our Search facets API returns for unique engine size. You can pass in multiple engine size values comma separated
Engine Aspiration to match. Valid filter values are those that our Search facets API returns for unique Engine Aspirations. You can pass in multiple Engine aspirations values comma separated
Engine Block to match. Valid filter values are those that our Search facets API returns for unique Engine Block. You can pass in multiple Engine Block values comma separated
Highway mileage range to filter listings with the mileage in the range given. Range to be given in the format - min-max e.g. 1000-5000
City mileage range to filter listings with the mileage in the range given. Range to be given in the format - min-max e.g. 1000-5000
Miles range to filter listings with miles in the given range. Range to be given in the format - min-max e.g. 1000-5000
Price range to filter listings with the price in the range given. Range to be given in the format - min-max e.g. 1000-5000
MSRP range to filter listings with the msrp in the range given. Range to be given in the format - min-max e.g. 1000-5000
Days on Market range to filter cars with the DOM within the given range. Range to be given in the format - min-max e.g. 10-50
Name of the dealership group to search for
Active Days on Market range to filter cars with the DOM within the given range. Range to be given in the format - min-max e.g. 10-50
Last 180 Days on Market range to filter cars with the DOM within the given range. Range to be given in the format - min-max e.g. 10-50
To filter listing on their fuel type
Filter based on dealer type independant or franchise
Engine size range to filter listings with engine size in the given range. Range to be given in the format - min-max e.g. 1.0-2
Response
Provides Market Days supply for year make model or trim combination