v1

latestOpenAPI 3.0.02026-07-147195292.0 KB
Cars Market API

Market Days Supply

Get the basic information on specifications for a car identified by a valid VIN

get/mds/car

Query parameters

api_keystring

The API Authentication Key. Mandatory with all API calls.

vinstring string

VIN to decode

exactboolean

Exact parameter

latitudenumber double

Latitude component of location

longitudenumber double

Longitude component of location

radiusinteger

Radius around the search location (Unit - Miles)

zipstring

To filter listing on ZIP around which they are listed

msa_codestring

To filter listing on msa code in which they are listed

debugboolean

Debug parameter

include_soldboolean

To fetch sold vins

country'US' | 'CA' | 'us' | 'ca'

To filter listing on Country in which they are listed

statestring

To filter listing on State in which they are listed

citystring

To filter listing on City in which they are listed

ymmtstring

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'new' | 'used' | 'certified'

Car type. Allowed values are - new / used / certified

lease_termstring

Search listings with exact lease term, or inside a range with min and max seperated by a dash like lease_term=30-60

lease_down_paymentstring

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

lease_empstring

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

finance_loan_termstring

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

finance_loan_aprstring

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

finance_empstring

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

finance_down_paymentstring

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

finance_down_payment_perstring

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

carfax_1_owner'true' | 'false'

Indicates whether car has had only one owner or not

carfax_clean_title'true' | 'false'

Indicates whether car has clean ownership records

yearstring

To filter listing on their year

makestring

To filter listings on their make

modelstring

To filter listings on their model

trimstring

To filter listing on their trim

dealer_idstring string

Dealer id to filter the listings.

sourcestring

To filter listing on their source

body_typestring

To filter listing on their body type

body_subtypestring string

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

vehicle_typestring

To filter listing on their vehicle type

cylindersstring

To filter listing on their cylinders

transmissionstring

To filter listing on their transmission

doorsstring string

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

drivetrainstring

To filter listing on their drivetrain

exterior_colorstring

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_colorstring

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_colorstring

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_colorstring

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

enginestring

To filter listing on their engine

engine_sizestring

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_aspirationstring

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_blockstring

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_mpg_rangestring string

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_mpg_rangestring string

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_rangestring string

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_rangestring string

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_rangestring string

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

dom_rangestring string

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

dealership_group_namestring string

Name of the dealership group to search for

dom_active_rangestring string

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

dom_180_rangestring string

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

fuel_typestring

To filter listing on their fuel type

dealer_type'franchise' | 'independent'

Filter based on dealer type independant or franchise

engine_size_rangestring string

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

makestring

Make of vin provided

mdsinteger

Provides Market days supply count

modelstring

Model of vin provided

sold_vinsstring[]

Sold vins array

total_active_cars_for_ymmtinteger

Active cars for ymmt combination

total_cars_sold_in_last_45_daysinteger

Cars sold in last 45 days

trimstring

Trim of vin provided

yearinteger

Year of vin provided