Cars / Market Insights

Market Days Supply

get/mds/car

Request

  • Base URL: https://api.marketcheck.com/v2
  • URL: https://api.marketcheck.com/v2/mds/car
  • Auth: API key in query parameter api_key

Query parameters

base_ext_colorstring

The base exterior color to filter results by (e.g. White, Black, Blue, Silver, Red). Accepts multiple colors as a comma-separated list.

base_int_colorstring

The base interior color to filter results by (e.g. Black, Brown, Beige, Red). Accepts multiple colors as a comma-separated list.

body_subtypestring

Filters listings by body subtype (e.g., Crew, Extended, Regular, Extended Crew). Accepts multiple values separated by commas.

body_typestring

Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.

car_typestring

Filters listings by inventory type. Allowed values - new, used, certified.

carfax_1_ownerboolean

If true, returns only vehicles with a single previous owner; if false or omitted, no ownership filter is applied. Default — false.

carfax_clean_titleboolean

If true, returns only vehicles with a clean title history; if false or omitted, no title filter is applied. Default — false.

citystring

Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).

city_mpg_rangestring

Filters listings by city fuel-economy mileage. Specify as min-max MPG (e.g., 20-35).

countrystring

Filters listings by country code. Allowed values - us, ca, all. Default — us.

cylindersstring

Filters listings by engine cylinder count (e.g., 4, 6, 8). Accepts multiple values as a comma-separated list.

dealer_idstring

Filters listings by MarketCheck dealer ID.

dealer_typestring

Filters dealers by type. Allowed values — franchise, independent.

dealership_group_namestring

Filters listings by the name of the dealership group. Accepts multiple values as a comma-separated list.

debugboolean

If true, returns applied year, make, model, and trim filters in the response. Default — false.

dom_180_rangestring

Filters listings by Days on Market observed over the last 180 days. Specify as min-max days (e.g., 10-50).

dom_active_rangestring

Filters listings by active Days on Market (DOM). Specify as min-max days.

dom_rangestring

Filters listings by total Days on Market (DOM). Specify as min-max days.

doorsstring

Filters listings by number of doors (e.g., 2, 4). Accepts multiple values as comma-separated list.

dos_active_rangestring

Filters listings by active Days on Site (DOS). Specify as min-max days.

drivetrainstring

Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.

enginestring

Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.

engine_aspirationstring

Filters listings by engine aspiration (Turbocharged, Naturally Aspirated, etc.). Accepts multiple values separated by commas.

engine_blockstring

Filters listings by engine block layout (V, I, H). Accepts multiple values separated by commas.

engine_sizestring

Filters listings by engine displacement size (e.g., 2.0, 2.5, 3.5). Accepts multiple values separated by commas.

engine_size_rangestring

Filters listings by engine displacement size. Specify as min-max liters (e.g., 1.5-3.0).

exactboolean

If true, performs exact matching (upto build_code level) in MDS API queries. If false, performs partial matching (upto model level). Default — false.

exclude_certifiedboolean

If true, excludes certified-pre-owned vehicles from results. Default — false. See car_type parameter for filtering by inventory type for certified vehicles.

exterior_colorstring

Filters listings by exterior color (e.g. White, Summit White, Gun Metallic). Accepts multiple values as comma-separated list.

finance_down_paymentstring

Filters listings by finance down-payment amount in USD. Specify a single value or a min-max range.

finance_down_payment_perstring

Filters listings by finance down-payment percentage. Specify a single value or min-max.

finance_empstring

Filters listings by finance Estimated Monthly Payment (EMP) in USD. Specify a single value or min-max.

finance_loan_aprstring

Filters listings by finance loan APR. Specify a single value or min-max.

finance_loan_termstring

Filters listings by finance loan term in months. Specify a single value or min-max months.

fuel_typestring

Filters listings by fuel type (e.g., Unleaded, Diesel, Electric, Premium Unleaded, Electric / Unleaded). Accepts multiple values separated by commas.

highway_mpg_rangestring

Filters listings by highway fuel-economy mileage. Specify as min-max MPG (e.g., 25-40).

in_transitboolean

If true, returns listings marked as in transit; if false or omitted, no in-transit filter is applied.

include_soldboolean

If true, includes array of sold VINs in MDS API responses. Default — false.

interior_colorstring

Filters listings by interior color. Accepts multiple values as comma-separated list.

latitudestring

Latitude component of the search location (decimal degrees). Used for geospatial queries along with longitude and radius parameters.

lease_down_paymentstring

Filters listings by lease down-payment amount in USD. Specify a single value or min-max.

lease_empstring

Filters listings by lease Estimated Monthly Payment (EMP) in USD. Specify a single value or min-max.

lease_termstring

Filters listings by lease term length in months. Specify a single value or min-max.

longitudestring

Longitude component of the search location (decimal degrees). Used for geospatial queries along with latitude and radius parameters.

makestring

Filters listings by vehicle make (e.g., Toyota, Ford, Mercedes-Benz). Accepts multiple values as comma-separated list.

miles_rangestring

Filters listings by odometer reading. Specify as min-max miles (e.g., 1000-50000).

modelstring

Filters listings by specific vehicle model (e.g., Camry). Accepts multiple values separated by commas.

msa_codestring

Filters listings by Metropolitan Statistical Area (MSA) code.

msrp_rangestring

Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as min-max USD (e.g., 20000-45000).

price_rangestring

Filters listings by advertised price in USD. Specify as min-max (e.g., 1000-50000).

radiusinteger

Search radius around the specified location in miles. Used with zip or latitude and longitude for geospatial queries.

sourcestring

Filters listings by website domain (e.g., autotrader.com, cars.com).

statestring

Filters listings by US or Canadian state/province code (e.g., CA, NY, ON). Accepts multiple codes separated by commas.

transmissionstring

Filters listings by transmission type (Automatic, Manual, etc.). Accepts multiple values separated by commas.

trimstring

Filters listings by vehicle trim (e.g., EX, Limited). Accepts multiple values separated by commas.

vehicle_typestring

Filters listings by vehicle type (Truck, Car). Accepts multiple values separated by commas.

has_priceboolean

Boolean param to filter listings that have a price (true) or no price (false).

has_milesboolean

Boolean param to filter listings that have a miles (true) or no miles (false).

vinstring

Filters listings by full 17-character Vehicle Identification Number (VIN).

yearstring

Filters listings by model year (e.g., 2020). Accepts multiple years separated by commas.

ymmtstring

Year-Make-Model-Trim composite string(s). Each combo uses pipe separators and combinations can be comma-separated. For example, 2019|Toyota|Camry|LE,2020|Honda|Civic|EX. Useful for finding multiple groups of similar cars. Alternatively, you can use vins or taxonomy_vins for VIN-based queries.

zipstring

Filters listings within the specified 5-digit ZIP code.

Response

Successful response. See the linked documentation page for the full field reference.

Changes

No recorded changes to this operation across all 1 revision of this API.