Market Days Supply

GET

/mds/car

Cars Market API

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marketcheck-prod.apigee.net/v2/mds/car'

Response Example

200 - Example 1

{
    "make": "string",
    "mds": 0,
    "model": "string",
    "sold_vins": [
        "string"
    ],
    "total_active_cars_for_ymmt": 0,
    "total_cars_sold_in_last_45_days": 0,
    "trim": "string",
    "year": 0
}

Request

Query Params

api_key

string

optional

The API Authentication Key. Mandatory with all API calls.

vin

string

optional

VIN to decode

exact

string

optional

Exact parameter

latitude

number

optional

Latitude component of location

longitude

number

optional

Longitude component of location

radius

integer

optional

Radius around the search location (Unit - Miles)

zip

string

optional

To filter listing on ZIP around which they are listed

msa_code

string

optional

To filter listing on msa code in which they are listed

debug

string

optional

Debug parameter

include_sold

string

optional

To fetch sold vins

country

string

optional

To filter listing on Country in which they are listed

state

string

optional

To filter listing on State in which they are listed

city

string

optional

To filter listing on City in which they are listed

ymmt

string

optional

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

string

optional

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

lease_term

string

optional

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_payment

string

optional

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_emp

string

optional

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_term

string

optional

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_apr

string

optional

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_emp

string

optional

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_payment

string

optional

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_per

string

optional

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

string

optional

Indicates whether car has had only one owner or not

carfax_clean_title

string

optional

Indicates whether car has clean ownership records

year

string

optional

To filter listing on their year

make

string

optional

To filter listings on their make

model

string

optional

To filter listings on their model

trim

string

optional

To filter listing on their trim

dealer_id

string

optional

Dealer id to filter the listings.

source

string

optional

To filter listing on their source

body_type

string

optional

To filter listing on their body type

body_subtype

string

optional

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_type

string

optional

To filter listing on their vehicle type

cylinders

string

optional

To filter listing on their cylinders

transmission

string

optional

To filter listing on their transmission

doors

string

optional

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

drivetrain

string

optional

To filter listing on their drivetrain

exterior_color

string

optional

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

string

optional

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

string

optional

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

string

optional

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

engine

string

optional

To filter listing on their engine

engine_size

string

optional

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

string

optional

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

string

optional

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_range

string

optional

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_range

string

optional

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

string

optional

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

string

optional

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

string

optional

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_range

string

optional

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_name

string

optional

Name of the dealership group to search for

dom_active_range

string

optional

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_range

string

optional

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_type

string

optional

To filter listing on their fuel type

dealer_type

string

optional

Filter based on dealer type independant or franchise

engine_size_range

string

optional

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

Responses

🟢200Provides Market Days supply for year make model or trim combination

application/json

Body

Describes Market days supply results for year make model trim combination

make

string

optional

Make of vin provided

mds

integer

optional

Provides Market days supply count

model

string

optional

Model of vin provided

sold_vins

array[string]

optional

Sold vins array

total_active_cars_for_ymmt

integer

optional

Active cars for ymmt combination

total_cars_sold_in_last_45_days

integer

optional

Cars sold in last 45 days

trim

string

optional

Trim of vin provided

year

integer

optional

Year of vin provided

🔴500Error

Modified at 2023-08-15 07:36:55

Gets active RV listings for the given search criteria

Get make model wise top 50 popular cars on national, state, city level