openapi: 3.0.0 info: title: MarketCheck Cars Dealer Inventory API description: Access the New, Used and Certified cars inventories for all Car Dealers in US. The data is sourced from online listings by over 44,000 Car dealers in US. At any time, there are about 6.2M searchable listings (about 1.9M unique VINs) for Used & Certified cars and about 6.6M (about 3.9M unique VINs) New Car listings from all over US. MarketCheck aggregates billions of data points from over 44,000 US and 3,500 Canadian dealerships, offering daily-updated inventory search, price prediction, market days supply, OEM incentives, auction listings, and third-party integrations for recalls, title checks, and plate-to-VIN lookups. version: 1.0.3 contact: name: MarketCheck url: https://www.marketcheck.com/ termsOfService: https://www.marketcheck.com/terms/ servers: - url: https://mc-api.marketcheck.com/v1 description: MarketCheck Production API tags: - name: Inventory description: Dealer inventory operations paths: /dealer/{dealer_id}/active/inventory: get: tags: - Inventory summary: Dealer inventory operationId: getDealerActiveInventory description: Get a dealer's currently active inventory parameters: - name: dealer_id in: path required: true description: Id representing the dealer to fetch the active inventory for schema: type: string - name: api_key in: query description: The API Authentication Key. Mandatory with all API calls. schema: type: string - name: rows in: query description: Number of results to return. Default is 10. Max is 50. schema: type: integer default: 10 maximum: 50 - name: start in: query description: Page number to fetch the results for the given criteria. Default is 1. schema: type: integer default: 1 responses: '200': description: Successful response with dealer active inventory content: application/json: schema: $ref: '#/components/schemas/BaseListing' /dealer/{dealer_id}/historical/inventory: get: tags: - Inventory summary: Dealer's historical inventory operationId: getDealerHistoricalInventory description: '[v1 : Not Implemented Yet] - Get a dealer''s historical inventory' parameters: - name: dealer_id in: path required: true description: Id representing the dealer to fetch the historical inventory for schema: type: string responses: '200': description: Successful response with dealer historical inventory content: application/json: schema: $ref: '#/components/schemas/BaseListing' components: schemas: Dealer: type: object description: Dealer information properties: id: type: string description: Unique dealer identifier name: type: string description: Dealer name website: type: string description: Dealer website URL dealer_type: type: string description: Type of dealership zip: type: string description: Dealer zip code city: type: string description: Dealer city state: type: string description: Dealer state latitude: type: number description: Dealer latitude longitude: type: number description: Dealer longitude phone: type: string description: Dealer phone number franchises: type: array items: type: string description: List of car franchises/makes the dealer carries BaseListing: type: object description: Base listing object containing minimal car listing information properties: id: type: string description: Unique listing identifier vin: type: string description: Vehicle Identification Number heading: type: string description: Listing heading / title price: type: number description: Listed price in USD miles: type: integer description: Odometer reading in miles msrp: type: number description: Manufacturer Suggested Retail Price data_source: type: string description: Source of the listing data source_url: type: string description: URL to the original listing source seller_type: type: string description: 'Type of seller: dealer, private, auction' enum: - dealer - private - auction car_type: type: string description: Type of car listing enum: - new - used - certified scraped_at: type: integer description: Unix timestamp when the listing was scraped last_seen_at: type: integer description: Unix timestamp when the listing was last seen first_seen_at: type: integer description: Unix timestamp when the listing was first seen dom: type: integer description: Days on market dom_180: type: integer description: Days on market in the last 180 days dom_active: type: integer description: Active days on market dealer_id: type: string description: Dealer identifier ref_price: type: number description: Reference/comparison price ref_miles: type: number description: Reference/comparison miles ref_year: type: integer description: Reference year build: $ref: '#/components/schemas/Build' dealer: $ref: '#/components/schemas/Dealer' Build: type: object description: Vehicle build/specification information decoded from VIN properties: year: type: integer description: Model year make: type: string description: Vehicle make model: type: string description: Vehicle model trim: type: string description: Vehicle trim level body_type: type: string description: Body type (sedan, SUV, truck, etc.) vehicle_type: type: string description: Vehicle type classification transmission: type: string description: Transmission type drivetrain: type: string description: Drivetrain type (FWD, AWD, RWD, 4WD) fuel_type: type: string description: Fuel type engine: type: string description: Engine description engine_size: type: string description: Engine displacement cylinders: type: integer description: Number of cylinders doors: type: integer description: Number of doors made_in: type: string description: Country of manufacture highway_fuel_economy: type: integer description: Highway fuel economy in MPG city_fuel_economy: type: integer description: City fuel economy in MPG externalDocs: description: MarketCheck API Documentation url: https://docs.marketcheck.com/docs/api/cars