{ "openapi": "3.1.0", "info": { "title": "MarketCheck Automotive Data API", "version": "2.0.0-20260903", "x-docs-sha": "d3b34de4596e4cc3ef589bf48fb9ca7f957900f5", "description": "North American and UK automotive market data: live and historical vehicle listings, dealers, VIN decode, vehicle history, and price prediction.\n\nAuthentication: every request takes `api_key=YOUR_API_KEY` as a QUERY PARAMETER (not a header). Get a key at https://developers.marketcheck.com.\n\nQuickstart: `curl \"https://api.marketcheck.com/v2/search/car/active?api_key=YOUR_API_KEY&make=Toyota&model=Camry&zip=30301&radius=50\"`\n\nRate limits: Free 500 calls/month at 5 rps; Basic 5,000/month at 5 rps; Standard pay-as-you-go at 40 rps; Enterprise custom. 429 responses carry Retry-After and RateLimit-*/Quota-* headers; the server timeout is 120 seconds.\n\nPagination: `start` + `rows` (rows max 50). Paging past your plan's deep-pagination limit returns HTTP 422; treat that as the end of results, not a retryable error.\n\nMore for AI coding assistants: https://developers.marketcheck.com/AGENTS.md (conventions file), https://developers.marketcheck.com/api/docs-mcp (docs MCP server), https://docs.marketcheck.com/llms.txt (docs index).", "contact": { "name": "MarketCheck", "url": "https://developers.marketcheck.com", "email": "api@marketcheck.com" }, "x-marketcheck-rate-limits": { "free": { "calls_per_month": 500, "rps": 5 }, "basic": { "calls_per_month": 5000, "rps": 5 }, "standard": { "quota": "pay-as-you-go", "rps": 40 }, "enterprise": "custom", "timeout_seconds": 120 } }, "externalDocs": { "description": "Full documentation", "url": "https://docs.marketcheck.com" }, "servers": [ { "url": "https://api.marketcheck.com/v2" } ], "security": [ { "api_key": [] } ], "tags": [ { "name": "Cars / Dealership Syndication" }, { "name": "Cars / Dealerships" }, { "name": "Cars / Incentives" }, { "name": "Cars / Inventory" }, { "name": "Cars / Market Insights" }, { "name": "Cars / Third Party" }, { "name": "Cars / Vehicle History" }, { "name": "Cars / Vehicle Listing" }, { "name": "Cars / Vehicle Specs" }, { "name": "Heavy Equipments / Dealerships" }, { "name": "Heavy Equipments / Inventory" }, { "name": "Heavy Equipments / Vehicle Listing" }, { "name": "Motorcycles / Dealerships" }, { "name": "Motorcycles / Inventory" }, { "name": "Motorcycles / Vehicle Listing" }, { "name": "Recreational Vehicles / Dealerships" }, { "name": "Recreational Vehicles / Inventory" }, { "name": "Recreational Vehicles / Vehicle Listing" }, { "name": "UK Cars / Dealerships" }, { "name": "UK Cars / Inventory" }, { "name": "UK Cars / Market Insights" }, { "name": "UK Cars / Vehicle History" }, { "name": "UK Cars / Vehicle Listing" }, { "name": "UK Recreational Vehicles / Inventory" }, { "name": "UK Recreational Vehicles / Vehicle Listing" } ], "paths": { "/batch/marketmatch/rank/jobs": { "get": { "operationId": "batchMarketmatchRankJobs", "summary": "MarketMatch: List Jobs", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "$ref": "#/components/parameters/country" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } }, "post": { "operationId": "postBatchMarketmatchRankJobs", "summary": "MarketMatch: Submit Job", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "$ref": "#/components/parameters/country" } ], "requestBody": { "required": true, "content": { "application/json": { "example": { "mimeType": "multipart/form-data", "params": [ { "name": "file", "fileName": "vehicles.csv.gz", "contentType": "application/gzip" }, { "name": "client_reference", "value": "ranking-batch-2026-04" } ] } } } }, "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/batch/marketmatch/rank/jobs/{job_id}": { "get": { "operationId": "batchMarketmatchRankJobsJobId", "summary": "MarketMatch: Get Job Status", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/country" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/batch/marketmatch/rank/jobs/{job_id}/download": { "post": { "operationId": "postBatchMarketmatchRankJobsJobIdDownload", "summary": "MarketMatch: Download Results", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/country" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/batch/neovin/decode/jobs": { "get": { "operationId": "batchNeovinDecodeJobs", "summary": "NeoVIN Decoder: List Jobs", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin" }, "parameters": [ { "$ref": "#/components/parameters/include_generic" }, { "$ref": "#/components/parameters/include_available_options" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } }, "post": { "operationId": "postBatchNeovinDecodeJobs", "summary": "NeoVIN Decoder: Submit Job", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin" }, "parameters": [ { "$ref": "#/components/parameters/include_generic" }, { "$ref": "#/components/parameters/include_available_options" } ], "requestBody": { "required": true, "content": { "application/json": { "example": { "mimeType": "multipart/form-data", "params": [ { "name": "file", "fileName": "vins.csv", "contentType": "text/csv" }, { "name": "client_reference", "value": "my-batch-2026-03-15" } ] } } } }, "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/batch/neovin/decode/jobs/{job_id}": { "get": { "operationId": "batchNeovinDecodeJobsJobId", "summary": "NeoVIN Decoder: Get Job Status", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin" }, "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/include_generic" }, { "$ref": "#/components/parameters/include_available_options" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/batch/neovin/decode/jobs/{job_id}/download": { "post": { "operationId": "postBatchNeovinDecodeJobsJobIdDownload", "summary": "NeoVIN Decoder: Download Results", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin" }, "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/include_generic" }, { "$ref": "#/components/parameters/include_available_options" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/car/autorecalls/{vin}": { "get": { "operationId": "carAutorecallsVin", "summary": "AutoRecalls", "tags": [ "Cars / Third Party" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/third-party/autorecalls" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/carsxe/plate-decoder/{plate}": { "get": { "operationId": "carsxePlateDecoderPlate", "summary": "CarsXE Vehicle Plate Decoder", "tags": [ "Cars / Third Party" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/third-party/carsxe" }, "parameters": [ { "name": "plate", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/country_v2" }, { "$ref": "#/components/parameters/state" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "success": true, "input": { "plate": "7XER187", "state": "CA", "country": "US" }, "description": "Kia Forte LX", "make": "Kia", "model": "Forte", "trim": "LX", "vin": "3KPFK4A78HE103497", "style": "Sedan 4D", "year": "2017", "registration_year": "2017", "engine_size": "2.0L I4 MPI", "assembly": "Mexico", "fuel_type": "Gasoline", "color": "White", "body_style": "Sedan", "engine": "2.0L I4 MPI", "drive_type": "FWD", "transmission": "Automatic" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealer/car/{dealer_id}": { "get": { "operationId": "dealerCarDealerId", "summary": "Dealer Details", "tags": [ "Cars / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/dealerships/dealer-details" }, "parameters": [ { "name": "dealer_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "10010052", "seller_name": "Carmax", "inventory_url": "carmax.com", "data_source": "mc", "status": "active", "listing_count": 84645, "dealer_type": "independent", "dealership_group_name": "Carmax", "street": "9131 South Memorial Drive", "city": "Saint Peters", "state": "OK", "country": "US", "zip": "74133", "latitude": "36.030444", "longitude": "-95.883741", "seller_phone": "122-220-0012", "created_at": "2020-04-13T13:37:06.000Z" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealer/car/uk/{dealer_id}": { "get": { "operationId": "dealerCarUkDealerId", "summary": "Dealer Details", "tags": [ "UK Cars / Dealerships" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/dealerships/dealer-details" }, "parameters": [ { "name": "dealer_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "10030188", "seller_name": "Marshall Motor Group", "inventory_url": "marshall.co.uk", "data_source": "mc", "status": "active", "listing_count": 7116, "dealer_type": "franchise", "dealership_group_name": "Constellation Automotive Holdings Limited", "fca_status": "Authorised", "fca_reference_no": "310503", "street": "Greyfriars Court", "city": "Milton Keynes", "country": "England", "county": "Buckinghamshire", "zip": "MK10 0BN", "postal_code": "MK10 0BN", "latitude": "52.039351", "longitude": "-0.692101", "seller_phone": "02392 656565", "created_at": "2021-04-09T08:55:49.000Z" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealer/heavy-equipment/{dealer_id}": { "get": { "operationId": "dealerHeavyEquipmentDealerId", "summary": "Dealer Details", "tags": [ "Heavy Equipments / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/heavy-equipments/dealerships/dealer-details" }, "parameters": [ { "name": "dealer_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "10860", "seller_name": "Best Choice Trailers", "inventory_url": "bestchoicetrailers.com", "data_source": "mc", "status": "active", "listing_count": 2444, "dealer_type": "franchise", "street": "1449 Arona Road", "city": "Irwin", "state": "PA", "country": "US", "zip": "15642", "latitude": "40.32451", "longitude": "-79.70115", "created_at": "2019-04-05T09:34:52.000Z" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealer/motorcycle/{dealer_id}": { "get": { "operationId": "dealerMotorcycleDealerId", "summary": "Dealer Details", "tags": [ "Motorcycles / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/motorcycles/dealerships/dealer-details" }, "parameters": [ { "name": "dealer_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "3377", "seller_name": "Free Ride Powersports", "inventory_url": "freeridepowersports.com", "data_source": "mc", "status": "active", "listing_count": 174, "dealer_type": "franchise", "street": "4405 Jackson Road Rd", "city": "Ann Arbor", "state": "MI", "country": "US", "zip": "48103", "latitude": "42.266638", "longitude": "-83.849042", "seller_phone": "734-585-3300", "created_at": "2019-03-13T05:10:44.000Z" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealer/rv/{dealer_id}": { "get": { "operationId": "dealerRvDealerId", "summary": "Dealer Details", "tags": [ "Recreational Vehicles / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/recreational-vehicles/dealerships/dealer-details" }, "parameters": [ { "name": "dealer_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "6490", "seller_name": "Mike Thompsons Rv Super Stores Rv Super Store", "inventory_url": "mikethompson.com", "data_source": "mc", "status": "active", "listing_count": 669, "dealer_type": "franchise", "street": "13940 Firestone Blvd", "city": "Santa Fe Springs", "state": "CA", "country": "US", "zip": "90670", "latitude": "33.886428", "longitude": "-118.034877", "seller_phone": "213-493-5445" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealers/car": { "get": { "operationId": "dealersCar", "summary": "Dealers Search", "tags": [ "Cars / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/dealerships/dealers-search" }, "parameters": [ { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/listing_count_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1, "dealers": [ { "id": "10010052", "seller_name": "Carmax", "inventory_url": "carmax.com", "data_source": "mc", "status": "active", "listing_count": 84645, "dealer_type": "independent", "dealership_group_name": "Carmax", "street": "9131 South Memorial Drive", "city": "Saint Peters", "state": "OK", "country": "US", "zip": "74133", "latitude": "36.030444", "longitude": "-95.883741", "seller_phone": "122-220-0012", "created_at": "2020-04-13T13:37:06.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealers/car/uk": { "get": { "operationId": "dealersCarUk", "summary": "Dealers Search", "tags": [ "UK Cars / Dealerships" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/dealerships/dealers-search" }, "parameters": [ { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/uk_dealer_country" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/fca_status" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/listing_count_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 111, "dealers": [ { "id": "10021775", "seller_name": "Mayfair Prestige", "inventory_url": "mayfairprestigeuk.co.uk", "data_source": "mc", "status": "active", "listing_count": 14, "dealer_type": "independent", "fca_status": "Authorised", "fca_reference_no": "624168", "street": "91 Crawford Street", "city": "London", "country": "England", "county": "Greater London", "zip": "W1H 2HD", "postal_code": "W1H 2HD", "latitude": "51.519226", "longitude": "-0.162144", "seller_phone": "02077 232860", "seller_email": "info@mayfairprestigeuk.co.uk", "created_at": "2021-02-12T11:34:29.000Z" }, { "id": "10021890", "seller_name": "Automotive Direct Ltd", "inventory_url": "automotivedirectltd.co.uk", "data_source": "mc", "status": "active", "listing_count": 29, "dealer_type": "independent", "fca_status": "Authorised", "fca_reference_no": "782376", "street": "377 North Circular Road", "city": "London", "country": "England", "county": "Greater London", "zip": "N13 5UU", "postal_code": "N13 5UU", "latitude": "51.612789", "longitude": "-0.107614", "seller_phone": "07542 626164", "seller_email": "automotivedirectltd@gmail.com", "created_at": "2021-02-12T11:44:43.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealers/heavy-equipment": { "get": { "operationId": "dealersHeavyEquipment", "summary": "Dealers Search", "tags": [ "Heavy Equipments / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/heavy-equipments/dealerships/dealers-search" }, "parameters": [ { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/listing_count_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v2" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1, "dealers": [ { "id": "11681", "seller_name": "Lauf Equipment", "inventory_url": "laufequipment.com", "data_source": "mc", "status": "active", "listing_count": 99, "dealer_type": "franchise", "street": "541 Mo94", "city": "Jefferson City", "state": "MO", "country": "US", "zip": "65101", "latitude": "38.494029", "longitude": "-92.165194", "seller_phone": "573-635-6836", "created_at": "2019-04-05T09:36:43.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealers/motorcycle": { "get": { "operationId": "dealersMotorcycle", "summary": "Dealers Search", "tags": [ "Motorcycles / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/motorcycles/dealerships/dealers-search" }, "parameters": [ { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/listing_count_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v2" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1, "dealers": [ { "id": "10001194", "seller_name": "Halls Motorsports Emerald Coasts Motorsports Emerald Coast", "inventory_url": "hallsflorida.com", "data_source": "mc", "status": "active", "listing_count": 99, "dealer_type": "franchise", "street": "655 W. James Lee Blvd", "city": "Crestview", "state": "FL", "country": "US", "zip": "32536", "latitude": "30.764425", "longitude": "-86.587619", "seller_phone": "850-398-6028", "created_at": "2019-12-09T14:00:05.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealers/rv": { "get": { "operationId": "dealersRv", "summary": "Dealers Search", "tags": [ "Recreational Vehicles / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/recreational-vehicles/dealerships/dealers-search" }, "parameters": [ { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/listing_count_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1, "dealers": [ { "id": "10000004", "seller_name": "Dad& 39 S Camper Outlet Gulfport", "inventory_url": "dadscamperoutlet.com", "data_source": "mc", "status": "active", "listing_count": 426, "dealer_type": "franchise", "street": "14101 Hwy 49", "city": "Gulfport", "state": "MS", "country": "US", "zip": "39503", "latitude": "30.488597", "longitude": "-89.105177", "seller_phone": "228-206-0282", "created_at": "2019-05-30T09:25:26.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealerships/car": { "get": { "operationId": "dealershipsCar", "summary": "Dealerships Search", "tags": [ "Cars / Dealerships" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/dealerships/dealerships" }, "parameters": [ { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 85934, "mc_dealerships": [ { "mc_website_id": "4480", "mc_dealer_id": "1094053", "mc_location_id": "1485834", "mc_rooftop_id": "249314", "mc_category": "Dealer", "seller_name": "atlas auto sales", "inventory_url": "atlasautosales.com", "status": "active", "dealer_type": "independent", "street": "3715 Reynolda Road", "city": "Winston-Salem", "state": "NC", "country": "US", "zip": "27106", "latitude": "36.160235", "longitude": "-80.321463", "seller_phone": "336-924-8995" }, { "mc_website_id": "14750", "mc_dealer_id": "1160029", "mc_location_id": "1409122", "mc_rooftop_id": "1016933", "mc_category": "Dealer", "seller_name": "elk grove auto mall", "inventory_url": "elkgroveautomall.com", "status": "active", "dealer_type": "franchise", "street": "8550 Laguna Grove Drive", "city": "Elk Grove", "state": "CA", "country": "US", "zip": "95757", "latitude": "38.405745", "longitude": "-121.388206", "seller_phone": "877-707-7764" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealerships/car/uk": { "get": { "operationId": "dealershipsCarUk", "summary": "Dealerships Search", "tags": [ "UK Cars / Dealerships" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/dealerships/dealerships" }, "parameters": [ { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/uk_dealer_country" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/created_at_days" }, { "$ref": "#/components/parameters/created_at_range" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/fca_status" }, { "$ref": "#/components/parameters/inventory_url" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 21483, "mc_dealerships": [ { "mc_website_id": "10021768", "mc_dealer_id": "1165564", "mc_location_id": "1440442", "mc_rooftop_id": "69211", "mc_category": "Dealer", "seller_name": "Yellowstone Garage", "inventory_url": "yellowstonecars.co.uk", "status": "active", "dealer_type": "independent", "street": "256 Newcastle Road", "city": "Nantwich", "country": "England", "county": "Cheshire East", "zip": "CW5 7ET", "postal_code": "CW5 7ET", "latitude": "53.057886", "longitude": "-2.463424", "seller_phone": "01270 668144", "fca_status": "No longer authorised", "fca_reference_no": "307471", "created_at": "2021-02-12T11:33:59.000Z" }, { "mc_website_id": "10021769", "mc_dealer_id": "1168807", "mc_location_id": "1569061", "mc_rooftop_id": "133350", "mc_category": "Dealer", "seller_name": "A F Vehicle Sales", "inventory_url": "afvehiclesales.co.uk", "status": "active", "dealer_type": "independent", "street": "Coventry Road", "city": "Rugby", "country": "England", "county": "Warwickshire", "zip": "CV2 1NR", "postal_code": "CV2 1NR", "latitude": "52.458344", "longitude": "-1.452743", "seller_phone": "07747 665477", "fca_status": "Authorised", "fca_reference_no": "767648", "created_at": "2021-02-12T11:34:02.000Z" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealerships/inventory": { "get": { "operationId": "dealershipsInventory", "summary": "Dealership Inventory Syndication", "tags": [ "Cars / Dealership Syndication" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/dealership-syndication/dealership-inventory" }, "parameters": [ { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dealership_group_name" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/powertrain_type" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v3" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/version" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1510, "listings": [ { "id": "JTDVPMAE2MJ159394-02020730-b5c6", "vin": "JTDVPMAE2MJ159394", "heading": "2021 Toyota Corolla LE", "miles": 49410, "data_source": "mc", "vdp_url": "https://www.stgautogroup.com/inventory/2021-toyota-corolla-le-JTDVPMAE2MJ159394", "carfax_1_owner": true, "carfax_clean_title": false, "exterior_color": "White", "interior_color": "Black", "base_int_color": "Black", "base_ext_color": "White", "dom": 78, "dom_180": 2, "dom_active": 2, "dos_active": 2, "seller_type": "dealer", "inventory_type": "used", "stock_no": "X06158", "last_seen_at": 1758341222, "last_seen_at_date": "2025-09-20T04:07:02.000Z", "scraped_at": 1758258398, "scraped_at_date": "2025-09-19T05:06:38.000Z", "first_seen_at": 1758258398, "first_seen_at_date": "2025-09-19T05:06:38.000Z", "first_seen_at_mc": 1609463091, "first_seen_at_mc_date": "2021-01-01T01:04:51.000Z", "first_seen_at_source": 1758258398, "first_seen_at_source_date": "2025-09-19T05:06:38.000Z", "source": "stgautogroup.com", "in_transit": false, "car_location": { "seller_name": "STG Chandler" }, "media": { "photo_links": [ "https://static.overfuel.com/photos/1304/876994/e1fc1d7a896248d6b27224fa90be4718.webp?w=1920&q=80", "https://static.overfuel.com/photos/1304/876994/e1fc1d7a896248d6b27224fa90be4718.webp" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/JTDVPMAE2MJ159394-02020730-b5c6/e4766c0246fe4b64e26bf72d3e59b431?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/JTDVPMAE2MJ159394-02020730-b5c6/338fc742f70d6e144b7b8ac5e7b5defd?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 1035095, "website": "stgautogroup.com", "name": "Stg Auto Group", "dealer_type": "independent", "street": "10477 Central Ave", "city": "Montclair", "state": "CA", "country": "US", "latitude": "34.064021", "longitude": "-117.688996", "zip": "91763", "msa_code": "6780", "phone": "909-341-1189", "seller_email": "iecustomerservice@stgautogroup.com" }, "mc_dealership": { "mc_website_id": 1035095, "mc_dealer_id": 1055119, "mc_location_id": 1474601, "mc_rooftop_id": 640368, "mc_category": "Dealer", "website": "stgautogroup.com", "name": "Stg Auto Group", "dealer_type": "independent", "street": "10477 Central Ave", "city": "Montclair", "state": "CA", "country": "US", "latitude": "34.064021", "longitude": "-117.688996", "zip": "91763", "msa_code": "6780", "phone": "909-341-1189", "seller_email": "iecustomerservice@stgautogroup.com" }, "build": { "year": 2021, "make": "Toyota", "model": "Corolla", "trim": "LE", "version": "LE CVT", "body_type": "Sedan", "vehicle_type": "Car", "transmission": "CVT", "drivetrain": "FWD", "fuel_type": "Unleaded", "engine": "1.8L I4", "engine_size": 1.8, "engine_block": "I", "doors": 4, "cylinders": 4, "overall_height": "58.5", "overall_width": "70.1", "std_seating": "5", "highway_mpg": 41, "city_mpg": 32, "powertrain_type": "Combustion" } }, { "id": "1FBZX2ZM1FKB23540-00524929-62c9", "vin": "1FBZX2ZM1FKB23540", "heading": "2015 Ford Transit-350 XL w/ Privacy glass", "price": 32732, "price_change_percent": -0.47, "miles": 20998, "msrp": 32732, "data_source": "mc", "vdp_url": "https://www.stgautogroup.com/inventory/2015-ford-transit-350-xl-w-privacy-glass-1FBZX2ZM1FKB23540", "carfax_1_owner": true, "carfax_clean_title": false, "exterior_color": "Oxford White", "interior_color": "Pewter", "base_int_color": "Gray", "base_ext_color": "White", "dom": 126, "dom_180": 126, "dom_active": 126, "dos_active": 126, "seller_type": "dealer", "inventory_type": "used", "stock_no": "T66848", "last_seen_at": 1758340990, "last_seen_at_date": "2025-09-20T04:03:10.000Z", "scraped_at": 1757735209, "scraped_at_date": "2025-09-13T03:46:49.000Z", "first_seen_at": 1757735209, "first_seen_at_date": "2025-09-13T03:46:49.000Z", "first_seen_at_mc": 1747550763, "first_seen_at_mc_date": "2025-05-18T06:46:03.000Z", "first_seen_at_source": 1747550763, "first_seen_at_source_date": "2025-05-18T06:46:03.000Z", "ref_price": 32888, "ref_price_dt": 1757650120, "ref_miles": 20998, "ref_miles_dt": 1757650120, "source": "stgautogroup.com", "in_transit": false, "car_location": { "seller_name": "STG Montclair" }, "media": { "photo_links": [ "https://static.overfuel.com/photos/794/626906/d5505f9f00e14b1da6414911e5b64a8d.webp?w=1920&q=80", "https://static.overfuel.com/photos/794/626906/d5505f9f00e14b1da6414911e5b64a8d.webp" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/1FBZX2ZM1FKB23540-4057bd00-f718/437b17adc369c21f34ba1e8a91f9a4db?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/1FBZX2ZM1FKB23540-4057bd00-f718/ae8b381c4989b48ba8d7429605c305b5?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 1035095, "website": "stgautogroup.com", "name": "Stg Auto Group", "dealer_type": "independent", "street": "10477 Central Ave", "city": "Montclair", "state": "CA", "country": "US", "latitude": "34.064021", "longitude": "-117.688996", "zip": "91763", "msa_code": "6780", "phone": "909-341-1189", "seller_email": "iecustomerservice@stgautogroup.com" }, "mc_dealership": { "mc_website_id": 1035095, "mc_dealer_id": 1055119, "mc_location_id": 1474601, "mc_rooftop_id": 640368, "mc_category": "Dealer", "website": "stgautogroup.com", "name": "Stg Auto Group", "dealer_type": "independent", "street": "10477 Central Ave", "city": "Montclair", "state": "CA", "country": "US", "latitude": "34.064021", "longitude": "-117.688996", "zip": "91763", "msa_code": "6780", "phone": "909-341-1189", "seller_email": "iecustomerservice@stgautogroup.com" }, "build": { "year": 2015, "make": "Ford", "model": "Transit", "trim": "XL", "version": "350 XL Wagon Low Roof 60/40 Pass. 148 WB", "body_type": "Passenger Van", "vehicle_type": "Truck", "transmission": "Automatic", "drivetrain": "RWD", "fuel_type": "E85 / Unleaded", "engine": "3.7L V6", "engine_size": 3.7, "engine_block": "V", "doors": 4, "cylinders": 6, "overall_height": "83.2", "overall_width": "81.3", "std_seating": "8", "powertrain_type": "Combustion" } } ], "facets": { "year": [ { "item": "2022", "count": 290 }, { "item": "2023", "count": 265 } ], "make": [ { "item": "Toyota", "count": 219 }, { "item": "Chevrolet", "count": 118 } ] }, "stats": { "price": { "min": 3998, "max": 399000, "count": 1353, "missing": 157, "sum": 38074718, "mean": 28140.96, "stddev": 19191.26, "sum_of_squares": 1569775053888, "median": 25567, "percentiles": { "5.0": 13777.4, "25.0": 18998, "50.0": 25567, "75.0": 33028, "90.0": 41571, "95.0": 48462.2, "99.0": 71386.8 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/dealerships/inventory/marketplaces/{marketplace_name}": { "get": { "operationId": "dealershipsInventoryMarketplacesMarketplaceName", "summary": "Marketplace Inventory Syndication", "tags": [ "Cars / Dealership Syndication" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/dealership-syndication/marketplace-inventory" }, "parameters": [ { "name": "marketplace_name", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dealership_group_name" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/powertrain_type" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v3" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/version" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 178, "listings": [ { "vehicle_id": "5XXG14J20NG150912-0f90feda-78d6", "vin": "5XXG14J20NG150912", "url": "https://www.worldcarkianorth.com/auto/preowned-2022-kia-k5-lxs-san-antonio-tx/103222549/", "title": "Certified 2022 Kia K5 LXS", "year": 2022, "make": "Kia", "model": "K5", "trim": "LXS", "price": "-1 USD", "exterior_color": "Everlasting Silver", "interior_color": "Black", "state_of_vehicle": "CPO", "body_style": "SEDAN", "description": "2022 Kia K5 LXS with Automatic transmission, 1.6L I4 engine, Unleaded fuel. Available at World Car Kia North", "mileage": { "value": 43272, "unit": "MI" }, "image": [ { "url": "https://cloudflareimages.dealereprocess.com/resrc/images/c_limit,f_auto,fl_lossy,w_auto/v1/dvp/1167/24518888737-aHR0cDovL2ltYWdlcy51bml0c2ludmVudG9yeS5jb20vdXBsb2Fkcy9waG90b3MvMC8yMDI1LTA4LTExLzEtMjIxNjk2NDctNjg5YTNjMjg2MWM5OC5qcGc=", "tag": [ "Car" ] }, { "url": "https://cloudflareimages.dealereprocess.com/resrc/images/c_limit,fl_lossy,w_auto/v1/dvp/1167/24518888737/Pre-Owned-2022-Kia-K5-LXS-ID24518888737-aHR0cDovL2ltYWdlcy51bml0c2ludmVudG9yeS5jb20vdXBsb2Fkcy9waG90b3MvMC8yMDI1LTA4LTExLzEtMjIxNjk2NDctNjg5YTNjMjg2MWM5OC5qcGc=", "tag": [ "Car" ] } ], "vehicle_type": "car_truck", "drivetrain": "FWD", "fuel_type": "GASOLINE", "transmission": "Automatic", "availability": "AVAILABLE", "date_first_on_lot": "2025-03-31", "days_on_lot": 153, "address": { "addr1": "12115 N Interstate 35", "city": "San Antonio", "region": "TX", "country": "US", "postal_code": "78233" }, "latitude": "29.523229", "longitude": "-98.394032", "dealer_name": "World Car Kia North", "dealer_id": "1015993" }, { "vehicle_id": "KNDJ23AU8M7149626-95f8d211-0bcd", "vin": "KNDJ23AU8M7149626", "url": "https://www.worldcarkianorth.com/auto/preowned-2021-kia-soul-s-w-wheel-pkg-keyless-entry-lane-assist-rear-camera--17-wheels-san-antonio-tx/109704182/", "title": "Certified 2021 Kia Soul S w/ Wheel Pkg, Keyless Entry, Lane Assist, Rear Camera & 17\" Wheels", "year": 2021, "make": "Kia", "model": "Soul", "trim": "S", "price": "-1 USD", "exterior_color": "Snow White Pearl", "interior_color": "Black", "state_of_vehicle": "CPO", "body_style": "HATCHBACK", "description": "2021 Kia Soul S with Automatic transmission, 2.0L I4 engine, Unleaded fuel. Available at World Car Kia North", "mileage": { "value": 53692, "unit": "MI" }, "image": [ { "url": "https://cloudflareimages.dealereprocess.com/resrc/images/c_limit,f_auto,fl_lossy,w_auto/v1/dvp/1167/28726606262-aHR0cDovL2ltYWdlcy51bml0c2ludmVudG9yeS5jb20vdXBsb2Fkcy9waG90b3MvMC8yMDI1LTA5LTIzLzEtMjQ0NDczNjAtNjhkMmU2YWExMTRhOS5qcGc=", "tag": [ "Car" ] }, { "url": "https://cloudflareimages.dealereprocess.com/resrc/images/c_limit,fl_lossy,w_auto/v1/dvp/1167/28726606262/Pre-Owned-2021-Kia-Soul-SwWheelPkg,KeylessEntry,LaneAssist,RearCamera&17%22Wheels-ID28726606262-aHR0cDovL2ltYWdlcy51bml0c2ludmVudG9yeS5jb20vdXBsb2Fkcy9waG90b3MvMC8yMDI1LTA5LTIzLzEtMjQ0NDczNjAtNjhkMmU2YWExMTRhOS5qcGc=", "tag": [ "Car" ] } ], "vehicle_type": "car_truck", "drivetrain": "FWD", "fuel_type": "GASOLINE", "transmission": "Automatic", "availability": "AVAILABLE", "date_first_on_lot": "2025-08-31", "days_on_lot": 25, "address": { "addr1": "12115 N Interstate 35", "city": "San Antonio", "region": "TX", "country": "US", "postal_code": "78233" }, "latitude": "29.523229", "longitude": "-98.394032", "dealer_name": "World Car Kia North", "dealer_id": "1015993" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/decode/car/{vin}/specs": { "get": { "operationId": "decodeCarVinSpecs", "summary": "Basic VIN Decoder", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/basic" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "is_valid": true, "decode_mode": "fullVIN", "year": 2012, "make": "Ford", "model": "Focus", "trim": "SE", "body_type": "Sedan", "vehicle_type": "Car", "transmission": "Manual", "drivetrain": "FWD", "fuel_type": "Unleaded", "engine": "2.0L I4", "engine_size": 2, "doors": 4, "cylinders": 4, "made_in": "USA", "overall_height": "57.7", "overall_length": "178.5", "overall_width": "71.8", "std_seating": "5", "highway_mpg": 40, "city_mpg": 28, "powertrain_type": "Combustion" } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/decode/car/epi/{vin}/specs": { "get": { "operationId": "decodeCarEpiVinSpecs", "summary": "Enhanced VIN Decoder", "tags": [ "Cars / Third Party" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/third-party/epi" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/decode/car/neovin/{vin}/options-packages": { "get": { "operationId": "decodeCarNeovinVinOptionsPackages", "summary": "Available Options Packages", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/available-options" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "vin": "3GNKBHR48PS212775", "country": "US", "available_options_packages": [ { "code": "00V", "name": "Credit - Not Equipped with Front Heated Seats", "msrp": "-50" }, { "code": "00Y", "name": "Credit - Not Equipped with Rear Park Assist", "msrp": "-50" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/decode/car/neovin/{vin}/specs": { "get": { "operationId": "decodeCarNeovinVinSpecs", "summary": "NeoVIN Decoder", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/include_generic" }, { "$ref": "#/components/parameters/include_available_options" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "vin": "WA1BBAFY7P2183119", "squish_vin": "WA1BBAFY_P2", "year": 2023, "make": "Audi", "model": "Q5", "vehicle_type": "Truck", "listing_confidence": "mc_listings|new|dealer|franchise|17", "trim": "Premium Plus", "trim_confidence": "mc_listings|new|dealer|franchise|heading|exact_match", "version": "40 Premium Plus", "version_confidence": "single|latest", "transmission": "Automatic", "transmission_confidence": "mc_listings|new|dealer|franchise|orig|exact_match", "transmission_description": "Dual Clutch Sequential Trans (DCT)", "drivetrain": "4WD", "powertrain_type": "MHEV", "engine": "2.0L I4", "fuel_type": "Premium Unleaded", "doors": 5, "body_type": "SUV", "width": 74.8, "height": 65.7, "length": 185.7, "city_mpg": 23, "highway_mpg": 30, "manufacturer_code": "FYGBZY/WPS", "msrp": 49400, "delivery_charges": 1195, "installed_options_msrp": 595, "combined_msrp": 51190, "interior_color": { "code": "BG", "name": "Okapi Brown Leather", "confidence": "0.73", "base": "Brown" }, "exterior_color": { "code": "H1H1", "name": "Manhattan Gray Metallic", "msrp": "595", "confidence": "1.0", "base": "Gray" }, "country": "USA", "seating_capacity": 5, "combined_mpg": 26, "rating": { "safety": { "front": 5, "side": 5, "overall": 5 }, "rollover": 4, "roof_strength": "Good" }, "warranty": { "total": { "duration": 48, "distance": 50000 }, "powertrain": { "duration": 48, "distance": 50000 }, "anti_corrosion": { "duration": 144, "distance": 9999999 }, "roadside_assistance": { "duration": 48, "distance": 9999999 } }, "options_packages": "H1H1", "installed_options_details": [ { "code": "H1H1", "name": "Manhattan Gray Metallic", "msrp": "595", "type": "Paint", "confidence": "Low", "verified": true, "rule": "Excludes", "sale_price": "595" } ], "features": { "H1H1": [ { "category": "Exterior", "feature_type": "External Color", "description": "Gray" } ], "STANDARD": [ { "category": "Comfort & Convenience", "feature_type": "Power Outlet", "description": "12 Volt Rear Power Outlet" }, { "category": "Comfort & Convenience", "feature_type": "Power Outlet", "description": "12 Volt Power Outlet" } ] }, "high_value_features": { "H1H1": [ { "category": "Exterior", "description": "Upgrade Paint" } ], "STANDARD": [ { "category": "Safety & Driver Assist", "description": "360 View Parking Device" }, { "category": "Safety & Driver Assist", "description": "Parking Assistance System" } ] }, "installed_equipment": { "H1H1": [ { "category": "Exterior", "item": "external color", "attribute": "external color", "location": "", "value": "standard" }, { "category": "Exterior", "item": "external color", "attribute": "color", "location": "", "value": "gray" } ], "STANDARD": [ { "category": "Interior", "item": "Front seat", "attribute": "reclining type", "location": "passenger", "value": "electric" }, { "category": "Interior", "item": "Front seat", "attribute": "reach type", "location": "passenger", "value": "electric" } ] }, "created_at": 1752253170, "created_at_date": "2025-07-11T16:59:30.000Z", "updated_at": 1752253170, "updated_at_date": "2025-07-11T16:59:30.000Z", "decode_version": 1 } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/history/car/{vin}": { "get": { "operationId": "historyCarVin", "summary": "History by VIN", "tags": [ "Cars / Vehicle History" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-history/history-by-vin" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/fields" }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/sort_order_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": [ { "id": "1FTEW1C57MKD83429-aa90c455-6c61", "price": 29995, "miles": 112158, "data_source": "mc", "vdp_url": "https://www.hattiesburgcars.com/auto/used-2021-ford-f-150-xlt-hattiesburg-ms/107663785/", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1753152310, "last_seen_at_date": "2025-07-22T02:45:10.000Z", "scraped_at": 1752719667, "scraped_at_date": "2025-07-17T02:34:27.000Z", "first_seen_at": 1752719667, "first_seen_at_date": "2025-07-17T02:34:27.000Z", "source": "hattiesburgcars.com", "seller_name": "Hattiesburg Cars", "city": "Hattiesburg", "state": "MS", "zip": "39401", "status_date": 1753152310 }, { "id": "1FTEW1C57MKD83429-18d983b7-5d24", "price": 29995, "miles": 112158, "data_source": "mc", "vdp_url": "https://www.toyotahattiesburg.com/auto/used-2021-ford-f-150-xlt-hattiesburg-ms/107663785/", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1753076561, "last_seen_at_date": "2025-07-21T05:42:41.000Z", "scraped_at": 1753076561, "scraped_at_date": "2025-07-21T05:42:41.000Z", "first_seen_at": 1753076561, "first_seen_at_date": "2025-07-21T05:42:41.000Z", "source": "toyotahattiesburg.com", "seller_name": "Toyota Of Hattiesburg", "city": "Hattiesburg", "state": "MS", "zip": "39402", "status_date": 1753076561 } ] } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/history/car/uk/{vrm}": { "get": { "operationId": "historyCarUkVrm", "summary": "History by VRM", "tags": [ "UK Cars / Vehicle History" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/vehicle-history/history-by-vrm" }, "parameters": [ { "name": "vrm", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/page" }, { "$ref": "#/components/parameters/sort_order_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": [ { "id": "2d3df3711d5d23da98ece52d328f88a68272b22df924db2cd4175d818725ad7c", "price": 4295, "miles": 88269, "data_source": "mc", "vdp_url": "https://motorslocal.com/listing/2013-vauxhall-astra/", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1740563780, "last_seen_at_date": "2025-02-26T09:56:20.000Z", "scraped_at": 1723259586, "scraped_at_date": "2024-08-10T03:13:06.000Z", "first_seen_at": 1723259586, "first_seen_at_date": "2024-08-10T03:13:06.000Z", "source": "motorslocal.com", "seller_name": "Motorslocal", "city": "Doncaster", "zip": "DN4 9LX", "postal_code": "DN4 9LX", "status_date": 1740563780 }, { "id": "2d3df3711d5d23da98ece52d328f88a62c68c6e9b7fd08e73dc065cde3e914cc", "price": 4995, "miles": 91524, "data_source": "mc", "vdp_url": "https://motorslocal.com/listing/2013-vauxhall-astra/", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1677940443, "last_seen_at_date": "2023-03-04T14:34:03.000Z", "scraped_at": 1672815489, "scraped_at_date": "2023-01-04T06:58:09.000Z", "first_seen_at": 1672815489, "first_seen_at_date": "2023-01-04T06:58:09.000Z", "source": "motorslocal.com", "seller_name": "Motorslocal", "status_date": 1677940443 } ] } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/image/cache/car/{listing_id}/{image_id}": { "get": { "operationId": "imageCacheCarListingIdImageId", "summary": "Cached Image", "tags": [ "UK Cars / Vehicle Listing" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/vehicle-listing/cached-image" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "image_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/car/{listing_id}": { "get": { "operationId": "listingCarListingId", "summary": "Car Listing Details", "tags": [ "Cars / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-listing/car-listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "5TFUW5F16KX782196-44367fcc-c2fb", "vin": "5TFUW5F16KX782196", "heading": "Used 2019 Toyota Tundra SR5", "price": 27995, "price_change_percent": -3.09, "miles": 80203, "msrp": 27995, "data_source": "mc", "vdp_url": "https://www.autonationusa.com/used/Toyota/2019-Toyota-Tundra-8c8bd57cac1821a4025ac8172b1c3f9a.htm", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "Magnetic Gray Metallic", "interior_color": "Graphite", "base_int_color": "Gray", "base_ext_color": "Gray", "dom": 218, "dom_180": 83, "dom_active": 83, "dos_active": 82, "seller_type": "dealer", "inventory_type": "used", "stock_no": "KX782196", "last_seen_at": 1753153108, "last_seen_at_date": "2025-07-22T02:58:28.000Z", "scraped_at": 1752732629, "scraped_at_date": "2025-07-17T06:10:29.000Z", "first_seen_at": 1752732629, "first_seen_at_date": "2025-07-17T06:10:29.000Z", "first_seen_at_mc": 1536403570, "first_seen_at_mc_date": "2018-09-08T10:46:10.000Z", "first_seen_at_source": 1746166491, "first_seen_at_source_date": "2025-05-02T06:14:51.000Z", "ref_price": 28889, "ref_price_dt": 1752653949, "ref_miles": 80203, "ref_miles_dt": 1752653949, "source": "autonationusa.com", "in_transit": false, "car_location": { "mc_car_location_id": "1391837", "seller_name": "Autonation Usa Corpus Christi Tx", "street": "3115 S Padre Island Dr", "city": "Corpus Christi", "zip": "78415", "state": "TX", "latitude": "27.72844", "longitude": "-97.414846" }, "media": { "photo_links": [ "https://pictures.dealer.com/a/autonationusacorpuschristi/0560/ac989ccc55be223d2262782ef1b114eex.jpg", "https://pictures.dealer.com/a/autonationusacorpuschristi/1901/b22f84537d9c007fb0211af3a7ff134bx.jpg" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/5TFUW5F16KX782196-44367fcc-c2fb/e93cff16913e9d2a75f3197d3ba15c7d?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/5TFUW5F16KX782196-44367fcc-c2fb/09a26cb70e879b9b1f34a41f99c6f23b?api_key=YOUR_API_KEY" ] }, "extra": { "options": [ "SR5 Package", "Rear Under-Seat Storage Compartment" ], "features": [ "Lane departure", "Wireless phone connectivity" ], "seller_comments": "The following items have been reconditioned on this vehicle: new brakes! Sr5 Upgrade PackageFederal EmissionsGraphite; Fabric Seat TrimMagnetic Gray MetallicSr5 PackageThis vehicle includes a Money-Back Guarantee* and passed our precise inspection process. Best of all the price you see is the price you pay. No haggling. No back and forth. No pressure. And this price is so good it is guaranteed. *Money-Back Guarantee is valid for 5 days or 250 miles, whichever comes first. Subject to certain term...", "high_value_features": [ { "category": "Comfort & Convenience", "description": "Coming Home Device", "type": "Optional" }, { "category": "Safety & Driver Assist", "description": "Anti Collision System", "type": "Standard" } ], "options_packages": [ "RE", "SP" ] }, "dealer": { "id": 1079335, "website": "autonationusa.com", "name": "Autonation Usa Corpus Christi Tx", "dealer_type": "independent", "dealership_group_name": "AutoNation Inc.", "street": "3115 S Padre Island Dr", "city": "Corpus Christi", "state": "TX", "country": "US", "latitude": "27.72844", "longitude": "-97.414846", "zip": "78415", "msa_code": "1520", "phone": "725-291-5339" }, "mc_dealership": { "mc_website_id": 1079335, "mc_dealer_id": 1195242, "mc_location_id": 1391837, "mc_rooftop_id": 517078, "mc_dealership_group_id": 231, "mc_dealership_group_name": "AutoNation Inc.", "mc_sub_dealership_group_id": 231, "mc_sub_dealership_group_name": "AutoNation Inc.", "mc_category": "Retailer", "website": "autonationusa.com", "name": "Autonation Usa Corpus Christi Tx", "dealer_type": "independent", "street": "3115 S Padre Island Dr", "city": "Corpus Christi", "state": "TX", "country": "US", "latitude": "27.72844", "longitude": "-97.414846", "zip": "78415", "msa_code": "1520", "phone": "725-291-5339" }, "build": { "year": 2019, "make": "Toyota", "model": "Tundra", "trim": "SR5", "version": "SR5 5.7L 4WD FFV Double Cab Std Bed", "body_type": "Pickup", "body_subtype": "Extended", "vehicle_type": "Truck", "transmission": "Automatic", "drivetrain": "4WD", "fuel_type": "E85 / Unleaded", "engine": "5.7L V8", "engine_size": 5.7, "doors": 4, "cylinders": 8, "made_in": "USA", "overall_height": "76.4", "overall_length": "247.8", "overall_width": "79.9", "std_seating": "6", "highway_mpg": 17, "city_mpg": 13, "powertrain_type": "Combustion" } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/car/auction/{listing_id}": { "get": { "operationId": "listingCarAuctionListingId", "summary": "Auction Listing Details", "tags": [ "Cars / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-listing/auction-listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "W1N0J6EB2PG149336-d084e6e2-cd31", "vin": "W1N0J6EB2PG149336", "heading": "2023 Mercedes-Benz Glc Coupe", "miles": 0, "data_source": "mc", "vdp_url": "https://www.auto4export.com/lot/918480262/2023-mercedes-benz-glc-coupe", "dom": 135, "dom_180": 71, "dom_active": 71, "dos_active": 69, "seller_type": "auction", "inventory_type": "used", "last_seen_at": 1755744114, "last_seen_at_date": "2025-08-21T02:41:54.000Z", "scraped_at": 1749866013, "scraped_at_date": "2025-06-14T01:53:33.000Z", "first_seen_at": 1749866013, "first_seen_at_date": "2025-06-14T01:53:33.000Z", "first_seen_at_mc": 1704384797, "first_seen_at_mc_date": "2024-01-04T16:13:17.000Z", "first_seen_at_source": 1749866013, "first_seen_at_source_date": "2025-06-14T01:53:33.000Z", "source": "auto4export.com", "in_transit": false, "car_location": { "seller_name": "Chicago Heights, IL", "city": "Chicago Heights", "state": "IL" }, "media": { "photo_links": [ "http://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0525/9ab56cd1ba044e4b9295898e9ef12dcb_ful.jpg" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/W1N0J6EB2PG149336-d084e6e2-cd31/7c6c9437889d39ccb29c6cd5f55c6c9f?api_key=gEhl1WYgyQLywQlGoG46WNNTnzUjYhXx" ] }, "extra": { "seller_comments": "The clean title definition indicates that the vehicle has never been deemed a total loss but in some states a vehicle with clean title can have total loss history.it is the User s responsibility 1) to check the car's history and any notes on salvage records or Total loss ( for example NMVTIS report) 2) to verify with their specific state or jurisdiction that the vehicle can be legally titled and registered.We cannot guarantee that any vehicle purchased through our site will be able to be reco...", "high_value_features": [ { "category": "Interior", "description": "Heated Seats", "type": "Optional" }, { "category": "Safety & Driver Assist", "description": "Anti Collision System", "type": "Standard" } ], "options_packages": [ "872" ] }, "dealer": { "id": 1098455, "website": "auto4export.com", "name": "Auto4export Llc", "dealer_type": "independent", "street": "2305 Fourth St.", "city": "Tucker", "state": "GA", "country": "US", "latitude": "33.852599", "longitude": "-84.211871", "zip": "30084", "msa_code": "520", "phone": "470-300-4014", "seller_email": "sales@auto4export.com" }, "mc_dealership": { "mc_website_id": 1098455, "mc_dealer_id": 1092253, "mc_location_id": 1488823, "mc_rooftop_id": 855875, "mc_category": "Auction", "website": "auto4export.com", "name": "Auto4export Llc", "dealer_type": "independent", "street": "2305 Fourth St.", "city": "Tucker", "state": "GA", "country": "US", "latitude": "33.852599", "longitude": "-84.211871", "zip": "30084", "msa_code": "520", "phone": "470-300-4014", "seller_email": "sales@auto4export.com" }, "build": { "year": 2023, "make": "Mercedes-Benz", "model": "GLC Coupe", "trim": "Mercedes-AMG", "version": "Mercedes-AMG GLC 43 4MATIC", "body_type": "SUV", "vehicle_type": "Truck", "transmission": "Automatic", "drivetrain": "4WD", "fuel_type": "Premium Unleaded", "engine": "3.0L V6", "engine_size": 3, "doors": 5, "cylinders": 6, "made_in": "CA", "overall_height": "63.1", "overall_length": "188.7", "overall_width": "76.0", "std_seating": "5", "highway_mpg": 24, "city_mpg": 19, "powertrain_type": "Combustion" } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/car/fsbo/{listing_id}": { "get": { "operationId": "listingCarFsboListingId", "summary": "Private Party Listing Details", "tags": [ "Cars / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-listing/private-party-listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "5XYKUDA60DG350915-b6084fe1-5314", "vin": "5XYKUDA60DG350915", "heading": "2013 Kia Sorrento EX AWD loaded $6800 obo |", "price": 6800, "miles": 131500, "msrp": 6800, "data_source": "mc", "vdp_url": "https://racine.craigslist.org//cto/7867039651.html", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "silver", "base_ext_color": "Silver", "dom": 51, "dom_180": 1, "dom_active": 1, "dos_active": 1, "seller_type": "fsbo", "inventory_type": "used", "last_seen_at": 1753047046, "last_seen_at_date": "2025-07-20T21:30:46.000Z", "scraped_at": 1753047046, "scraped_at_date": "2025-07-20T21:30:46.000Z", "first_seen_at": 1753047046, "first_seen_at_date": "2025-07-20T21:30:46.000Z", "first_seen_at_mc": 1441850752, "first_seen_at_mc_date": "2015-09-10T02:05:52.000Z", "first_seen_at_source": 1753047046, "first_seen_at_source_date": "2025-07-20T21:30:46.000Z", "source": "craigslist.org", "in_transit": false, "car_location": { "city": "Lake Geneva", "zip": "53147", "state": "WI", "latitude": "42.589255", "longitude": "-88.439793" }, "media": { "photo_links": [ "https://images.craigslist.org/00q0q_3pRKnp3ovSW_0xL0t2_1200x900.jpg", "https://images.craigslist.org/00909_3K1eXcx7qBD_0t20CI_1200x900.jpg" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/5XYKUDA60DG350915-b6084fe1-5314/7fb079bbcf9d064ec86969ad4b25fb52?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/5XYKUDA60DG350915-b6084fe1-5314/adfe3174173e5ae75b5d28e343717c7c?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 1087211, "website": "craigslist.org", "name": "Private Seller", "country": "US" }, "mc_dealership": { "mc_website_id": 1087211, "mc_rooftop_id": 1003656, "mc_category": "FSBO", "website": "craigslist.org", "name": "Private Seller", "country": "US" }, "build": { "year": 2013, "make": "Kia", "model": "Sorento", "trim": "EX", "version": "EX AT 4WD", "body_type": "SUV", "vehicle_type": "Truck", "transmission": "Automatic", "drivetrain": "4WD", "fuel_type": "Unleaded", "engine": "2.4L I4", "engine_size": 2.4, "doors": 5, "cylinders": 4, "made_in": "USA", "overall_height": "67.3", "overall_length": "183.9", "overall_width": "74.2", "std_seating": "7", "highway_mpg": 27, "city_mpg": 21, "powertrain_type": "Combustion" }, "extra": { "high_value_features": [ { "category": "Infotainment", "description": "Satellite Radio", "type": "Standard" }, { "category": "Infotainment", "description": "Bluetooth", "type": "Standard" } ] } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/car/uk/{listing_id}": { "get": { "operationId": "listingCarUkListingId", "summary": "Car Listing Details", "tags": [ "UK Cars / Vehicle Listing" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/vehicle-listing/car-listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/redirect_to_active" }, { "$ref": "#/components/parameters/redirect_to_latest" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "5779a04bb69cd41e12e0292a5cb5306df2be5a30dc1cec952275b78f665f460f", "vehicle_registration_mark": "PY21OZR", "uvc_id": "M-LANGB", "heading": "2021 AUDI A1 30 Tfsi 110 Sport 5Dr Hatchback", "price": 14499, "miles": 49000, "data_source": "mc", "vdp_url": "https://www.charleshurstgroup.co.uk/used-car/audi/a1/30-tfsi-110-sport-5dr/id/734877", "exterior_color": "Grey", "base_ext_color": "Grey", "dom": 18, "dom_180": 18, "dom_active": 18, "dos_active": 18, "seller_type": "dealer", "inventory_type": "used", "vehicle_registration_date": "2021-07-17T00:00:00.000Z", "last_seen_at": 1753752737, "last_seen_at_date": "2025-07-29T01:32:17.000Z", "scraped_at": 1752288815, "scraped_at_date": "2025-07-12T02:53:35.000Z", "first_seen_at": 1752288815, "first_seen_at_date": "2025-07-12T02:53:35.000Z", "first_seen_at_mc": 1752288815, "first_seen_at_mc_date": "2025-07-12T02:53:35.000Z", "first_seen_at_source": 1752288815, "first_seen_at_source_date": "2025-07-12T02:53:35.000Z", "source": "charleshurstgroup.co.uk", "num_owners": "1", "car_location": { "mc_car_location_id": "1469394", "seller_name": "Usedirect Portadown", "street": "1 Carn Court", "city": "Portadown", "zip": "BT63 5YX", "county": "Armagh City, Banbridge And Craigavon", "latitude": "54.449627", "longitude": "-6.423698" }, "media": { "photo_links": [ "https://api.lookers.co.uk/imageserviceapi2/api/image/stock/80ee1eed-8217-4e3e-a94e-788c8ee9aa78", "https://api.lookers.co.uk/imageserviceapi2/api/image/stock/8abcdb25-938d-42a2-8ff1-7e3c6fa200f5" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/bfa0fa9e05722577da415f65ee69954e/16619abfebec8b6142076d7e249be804?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/bfa0fa9e05722577da415f65ee69954e/827ceacf7d43b408c56434e0250dd94f?api_key=YOUR_API_KEY" ] }, "extra": { "features": [ "Cruise control", "Bluetooth interface" ], "seller_comments": "The 2021 Audi A1 30 TFSI 110 Sport 5dr is an excellent choice for buyers looking for a small car that doesn t compromise on quality, technology, or driving enjoyment. As the most compact model in Audi s lineup, the A1 carries the brand s hallmark features refinement, precision engineering, and smart styling into the competitive supermini class. For drivers who want more than just basic transportation, the A1 delivers an experience that feels truly premium. Under the bonnet, the 30 TFSI badge ref...", "description_boilerplate": "This Audi A1 is 5 years old. With 49000 miles recorded, it has done an average of 9800 miles per year. First registered in 2021. This Grey Hatchback is for sale in the Belfast region for £14,499." }, "dealer": { "id": 10037750, "website": "charleshurstgroup.co.uk", "name": "Charles Hurst", "dealer_type": "franchise", "dealership_group_name": "Lookers PLC", "street": "62 Boucher Road", "city": "Belfast", "country": "Northern Ireland", "latitude": "54.571717", "longitude": "-5.968279", "zip": "BT12 6LR", "phone": "01292 270980", "postal_code": "BT12 6LR" }, "mc_dealership": { "mc_website_id": 10037750, "mc_dealer_id": 1167963, "mc_location_id": 1436723, "mc_rooftop_id": 192063, "mc_dealership_group_id": 271, "mc_dealership_group_name": "Lookers PLC", "mc_sub_dealership_group_id": 824, "mc_sub_dealership_group_name": "Charles Hurst", "mc_category": "Retailer", "website": "charleshurstgroup.co.uk", "name": "Charles Hurst", "dealer_type": "franchise", "street": "62 Boucher Road", "city": "Belfast", "country": "Northern Ireland", "latitude": "54.571717", "longitude": "-5.968279", "phone": "01292 270980", "postal_code": "BT12 6LR" }, "build": { "year": 2021, "make": "Audi", "variant": "Sportback 30 Tfsi Sport", "body_type": "Hatchback", "vehicle_type": "Car", "transmission": "Manual", "drivetrain": "4x2", "fuel_type": "Petrol", "engine": "1.0 110 Ps", "doors": 5, "cylinders": 3, "std_seating": "5", "trim": "Sportback 30 Tfsi Sport", "engine_size": 1, "model": "A1", "model_variant": "A1 Sportback 30 Tfsi Sport", "combined_mpg": 50.4, "performance_torque_ftlb": 129, "performance_maxspeed_mph": 126, "performance_torque_rpm": 1500, "performance_power_bhp": 108, "performance_power_rpm": 5000, "performance_torque_nm": 175, "performance_power_kw": 81, "euro_status": 6 } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/heavy-equipment/{listing_id}": { "get": { "operationId": "listingHeavyEquipmentListingId", "summary": "Heavy Equipment Listing Details", "tags": [ "Heavy Equipments / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/heavy-equipments/vehicle-listing/listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "3c504bbf898e08f282d28b19dfbe9a2f-97e60178-3dbb", "heading": "ECHO DPE-2600 With Battery & Rapid Charger", "vdp_url": "https://local.bahrns.com/new-models/echo-dpe-2600-with-battery-rapid-charger-29122552b", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1754530343, "last_seen_at_date": "2025-08-07T01:32:23.000Z", "scraped_at": 1728584634, "scraped_at_date": "2024-10-10T18:23:54.000Z", "first_seen_at": 1728584634, "first_seen_at_date": "2024-10-10T18:23:54.000Z", "source": "local.bahrns.com", "media": { "photo_links": [ "https://cdnmedia.endeavorsuite.com/images/ThumbGenerator/Thumb.aspx?img=//cdnmedia.endeavorsuite.com/images/catalogs/23398/products/detail/f2dab9db-a274-45ba-8878-77cbf64eb934.jpg&mw=1000&mh=563&f=1" ] }, "extra": { "seller_comments": "Designed for commercial landscapers, ECHO's DPE-2600 is a commercial-grade stick edger that, when used with an ECHO 5.0Ah battery, delivers an impressive runtime of up to 86 minutes. COMING SOON!" }, "dealer": { "id": 10007155, "website": "local.bahrns.com", "name": "Mh Equipment", "street": "817 E Voorhees St", "city": "Danville", "state": "IL", "latitude": "40.146339", "longitude": "-87.613939", "zip": "61832" }, "build": { "make": "ECHO", "model": "DPE-2600 With Battery & Rapid Charger", "engine": "Brushless", "length": "18.9 in." } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/motorcycle/{listing_id}": { "get": { "operationId": "listingMotorcycleListingId", "summary": "Motorcycle Listing Details", "tags": [ "Motorcycles / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/motorcycles/vehicle-listing/listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "3205a2928e1fc489b550c5194a8919e1-7f6d9de3-9603", "vin": "JYARM38E5SA019942", "heading": "2025 Yamaha YZF-R7 for Sale", "price": 8599, "miles": 5, "msrp": 9199, "vdp_url": "https://www.lonestaryamaha.com/Motorcycles-Yamaha-e7720e64-4a02-4bca-b6e1-b32c013ca425", "color": "Team Yamaha Blue", "seller_type": "dealer", "inventory_type": "new", "stock_no": "YAM9942", "last_seen_at": 1754531961, "last_seen_at_date": "2025-08-07T01:59:21.000Z", "scraped_at": 1754531961, "scraped_at_date": "2025-08-07T01:59:21.000Z", "first_seen_at": 1754531961, "first_seen_at_date": "2025-08-07T01:59:21.000Z", "source": "lonestaryamaha.com", "media": { "photo_links": [ "http://cdpcdn.dx1app.com/products/USA/YA/2025/MC/SPORT/YZF-R7/49/TEAM_YAMAHA_BLUE/2000000001_480px.jpg", "https://img.youtube.com/vi/KpFNO1j6RXQ/hqdefault.jpg" ] }, "extra": { "seller_comments": "A new generation Supersport with Yamaha's legendary styling combines an advanced CP2 engine with an ultra-thin and lightweight chassis to provide torquey performance on both the track and the street." }, "dealer": { "id": 3191, "website": "lonestaryamaha.com", "name": "Lone Star Yamaha Husqvarna Triumph", "dealer_type": "franchise", "street": "520 West Airport Freeway W Fwy", "city": "Irving", "state": "TX", "latitude": "32.84737", "longitude": "-96.957871", "zip": "75062", "msa_code": "1920" }, "build": { "year": 2025, "make": "Yamaha", "model": "Yzf", "trim": "R7", "vehicle_type": "MOTORCYCLE", "drivetrain": "Chain", "engine": "4-stroke, DOHC; 4-valves per cylinder", "overall_height": "45.7 in.", "overall_width": "27.8 in." } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/rv/{listing_id}": { "get": { "operationId": "listingRvListingId", "summary": "RV Listing Details", "tags": [ "Recreational Vehicles / Vehicle Listing" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/recreational-vehicles/vehicle-listing/listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "6616c05355bb62eed6446c59df548892-c26d9b49-f636", "vin": "4V2AU1D12PC092737", "heading": "Used 2023 Entegra Coach Aspire 44W", "price": 329995, "miles": 16195, "msrp": 551000, "vdp_url": "https://www.bluecompassrv.com/product/used-2023-entegra-coach-aspire-44w-2957368-10", "seller_type": "dealer", "inventory_type": "used", "stock_no": "UM121361", "last_seen_at": 1754444728, "last_seen_at_date": "2025-08-06T01:45:28.000Z", "scraped_at": 1752804755, "scraped_at_date": "2025-07-18T02:12:35.000Z", "first_seen_at": 1752804755, "first_seen_at_date": "2025-07-18T02:12:35.000Z", "source": "bluecompassrv.com", "media": { "photo_links": [ "https://cdn.impel.io/sts-content/overlays/prod/config_14814/4v2au1d12pc092737.jpg", "https://assets-cdn.interactcp.com/interactrv/unit_tech_drawing/unit_tech_drawing_202206061228317931111846.png?modified=0428202514374618" ], "floorplan_image_link": "https://assets-cdn.interactcp.com/interactrv/unit_tech_drawing/unit_tech_drawing_202206061228317931111846.png,qmodified=0428202514374618.pagespeed.ce.EpYrM9CghI.png" }, "extra": { "features": [ "Spartan K2 raised-rail chassis", "Cummins L9 turbocharged 450 HP engine with 1,250-lb. ft. torque at 1,400 RPM" ] }, "dealer": { "id": 10007599, "website": "bluecompassrv.com", "name": "Blue Compass Rv", "street": "3138 Hwy. 2e", "city": "Kalispell", "state": "MT", "country": "US", "latitude": "48.202765", "longitude": "-114.303919", "zip": "59901", "phone": "888-746-2351" }, "build": { "year": 2023, "make": "Entegra Coach", "model": "Aspire", "trim": "44w", "slideouts": "4", "sleeps": "4", "fuel_type": "Diesel", "engine": "Cummins L9", "length": "44.92", "gvwr": "49000", "chassis": "Spartan K2 Raised-Rail" } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/listing/rv/uk/{listing_id}": { "get": { "operationId": "listingRvUkListingId", "summary": "RV Listing Details", "tags": [ "UK Recreational Vehicles / Vehicle Listing" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/recreational-vehicles/vehicle-listing/vehicle-listing" }, "parameters": [ { "name": "listing_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "id": "5e26509baf03b28274d8041da8f6f0d8466698ce92fb50c3e54ec06848a6a4c55155ae97da94540a593b97f3c43ef332", "heading": "Swift Edge 464 Auto 2022 (Trade) motorhome", "price": 45995, "miles": 48500, "vdp_url": "https://www.caravanfinder.co.uk/motorhomes-for-sale/search-motorhomes/swift-edge-464-auto-used-motorhome-2022-lancashire-tx506cff2", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1754487166, "last_seen_at_date": "2025-08-06T13:32:46.000Z", "scraped_at": 1744983301, "scraped_at_date": "2025-04-18T13:35:01.000Z", "first_seen_at": 1744983301, "first_seen_at_date": "2025-04-18T13:35:01.000Z", "source": "caravanfinder.co.uk", "miles_indicator": "MILES", "currency_indicator": "GBP", "motorhome_build": "CoachBuilt", "origin": "CoachBuilt", "media": { "photo_links": [ "https://secure-img.webpurchaseimages.co.uk/products/caravanfinder/motorhomes/photos/dealer/92y2092/2025/68452903B619CF7180258C6E00377491/motorhome_2_sd.jpg", "https://secure-img.webpurchaseimages.co.uk/products/caravanfinder/motorhomes/photos/dealer/92y2092/2025/68452903B619CF7180258C6E00377491/motorhome_1_sd.jpg" ], "floorplan_image_link": "https://www.caravanfinder.co.uk/site/layouts/motorhomes/h375/4BSCWZCA014__h_375.png" }, "extra": { "options": [ "End Bedroom", "Fixed Bed" ] }, "dealer": { "id": 11009593, "website": "caravanfinder.co.uk", "name": "Stewart Longton Motorhomes Chorley", "street": "Chorley P", "city": "Chorley", "county": "Lancashire", "country": "UK", "latitude": "53.657351", "longitude": "-2.628834", "zip": "PR7 1SA", "phone": "01257 220222" }, "build": { "year": 2022, "make": "Swift", "model": "Swift Edge 464 Auto 2022 (Trade) motorhome", "transmission": "Automatic", "fuel_type": "Diesel", "engine": "2.3", "drive_type": "RHD", "chassis": "Fiat Ducato", "berths": "4", "exterior_length": "22.15", "mtplm": "3500 kg", "steering": "Power Steering", "category": "Motorhomes" } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/marketmatch/dealers/rank": { "post": { "operationId": "postMarketmatchDealersRank", "summary": "MarketMatch: Rank Dealers for a Vehicle", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "$ref": "#/components/parameters/country" } ], "requestBody": { "required": true, "content": { "application/json": { "example": { "vin": { "vin": "WP1BE2AY5PDA28064", "price": 20000, "miles": 3000 }, "dealers": [ { "source": "mbofaugusta.com", "zip": "30907" }, { "source": "acceleride.mbofaugusta.com", "zip": "30907" }, { "source": "acceleride.esterobaychevrolet.com", "zip": "33928" } ] } } } }, "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "ranked_matches": [ { "vin": "WP1BE2AY5PDA28064", "price": 20000, "miles": 3000, "source": "mbofaugusta.com", "zip": "30907", "mc_location_id": "1446052", "vin_score": 1680, "dealer_ymm_score": 0, "vin_rank": 1731 }, { "vin": "WP1BE2AY5PDA28064", "price": 20000, "miles": 3000, "source": "acceleride.mbofaugusta.com", "zip": "30907", "mc_location_id": "1446052", "vin_score": 1680, "dealer_ymm_score": 0, "vin_rank": 1731 } ], "failed_items": [] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/marketmatch/vins/rank": { "post": { "operationId": "postMarketmatchVinsRank", "summary": "MarketMatch: Rank Vehicles for a Dealer", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch" }, "parameters": [ { "$ref": "#/components/parameters/country" } ], "requestBody": { "required": true, "content": { "application/json": { "example": { "dealer": { "source": "mbofaugusta.com", "zip": "30907" }, "vins": [ { "vin": "5FNYF8H54SB000197", "price": 37610, "miles": 14428 }, { "vin": "JTJBM7FX1K5236458", "price": 35087, "miles": 73788 }, { "vin": "YV4L12RL4R1757085", "price": 33085, "miles": 45490 } ] } } } }, "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "ranked_matches": [ { "vin": "JTJBM7FX1K5236458", "price": 35087, "miles": 73788, "source": "mbofaugusta.com", "zip": "30907", "mc_location_id": "1446052", "vin_score": 1260, "dealer_ymm_score": 0, "vin_rank": 1312 }, { "vin": "YV4L12RL4R1757085", "price": 33085, "miles": 45490, "source": "mbofaugusta.com", "zip": "30907", "mc_location_id": "1446052", "vin_score": 1415, "dealer_ymm_score": 0, "vin_rank": 1468 } ], "failed_items": [] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/mds/car": { "get": { "operationId": "mdsCar", "summary": "Market Days Supply", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/market-days-supply" }, "parameters": [ { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/carfax_1_owner" }, { "$ref": "#/components/parameters/carfax_clean_title" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dealership_group_name" }, { "$ref": "#/components/parameters/debug" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exact" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/finance_down_payment" }, { "$ref": "#/components/parameters/finance_down_payment_per" }, { "$ref": "#/components/parameters/finance_emp" }, { "$ref": "#/components/parameters/finance_loan_apr" }, { "$ref": "#/components/parameters/finance_loan_term" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_sold" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_down_payment" }, { "$ref": "#/components/parameters/lease_emp" }, { "$ref": "#/components/parameters/lease_term" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/ymmt" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "mds": 57, "total_active_cars_for_ymmt": 20912, "total_cars_sold_in_last_45_days": 16541 } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/popular/cars": { "get": { "operationId": "popularCars", "summary": "Popular Cars", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/popular-cars" }, "parameters": [ { "$ref": "#/components/parameters/car_type_v2" }, { "$ref": "#/components/parameters/state_v3" }, { "$ref": "#/components/parameters/city_state" }, { "$ref": "#/components/parameters/country_v4" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/ca/marketcheck_price": { "get": { "operationId": "predictCarCaMarketcheckPrice", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 18518, "msrp": 23968 } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/ca/marketcheck_price/comparables": { "get": { "operationId": "predictCarCaMarketcheckPriceComparables", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 18518, "msrp": 23968, "comparables": { "num_found": 20, "listings": [ { "id": "3N1AB8CV6MY314187-dbbd68ac-518b", "vin": "3N1AB8CV6MY314187", "price": 19895, "miles": 35490, "dom": 206, "dom_180": 149, "dom_active": 12, "dos_active": 12, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocs02236/", "photo_url": "https://evalauto-resources.s3.us-east-2.amazonaws.com/concession/QC/42/cars/249990/thumbnails/medium/19a9355a1d49b0692.13325171.jpg", "dealer_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "mc_website_id": 11023909, "dist": 0.15 }, { "id": "3N1AB8CV8MY301568-76b201ec-cc5c", "vin": "3N1AB8CV8MY301568", "price": 16995, "miles": 16586, "dom": 10, "dom_180": 10, "dom_active": 10, "dos_active": 10, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "http://www.coupalbrassardnissan.com/en/used-inventory/Nissan/SENTRA/2021-Nissan-SENTRA-id38746875", "dealer_id": 1099683, "dealer_name": "Coupal Brassard Nissan St-jean", "latitude": "45.327774", "longitude": "-73.28661", "mc_website_id": 1099683, "dist": 62.31 } ], "stats": { "price": { "min": 9999, "max": 19895, "count": 20, "missing": 0, "sum": 336575, "mean": 16828.75, "stddev": 2226.15, "sum_of_squares": 5763251309, "median": 16998, "percentiles": { "5.0": 13693.55, "25.0": 15552.25, "50.0": 16998, "75.0": 18812.5, "90.0": 18995, "95.0": 19040, "99.0": 19724 } }, "miles": { "min": 16419, "max": 120645, "count": 20, "missing": 0, "sum": 957911, "mean": 47895.55, "stddev": 24159.82, "sum_of_squares": 57553612959, "median": 42575.5, "percentiles": { "5.0": 16577.65, "25.0": 34347.25, "50.0": 42575.5, "75.0": 61034, "90.0": 73544.1, "95.0": 79482.45, "99.0": 112412.49 } }, "dos_active": { "min": 2, "max": 215, "count": 20, "missing": 0, "sum": 700, "mean": 35, "stddev": 54.15, "sum_of_squares": 83134, "median": 14, "percentiles": { "5.0": 2, "25.0": 8.25, "50.0": 14, "75.0": 31.25, "90.0": 69.5, "95.0": 166.55, "99.0": 205.31 } } } }, "recent_comparables": { "num_found": 36, "listings": [ { "id": "3N1AB8CV6MY314187-9a9f4511-193d", "vin": "3N1AB8CV6MY314187", "price": 19895, "miles": 35489, "dom": 197, "dom_180": 140, "dom_active": 3, "dos_active": 3, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocs02236/", "dealer_id": 11023909, "mc_website_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "dist": 0.15 }, { "id": "3N1AB8CVXMY314161-f3eb8273-464a", "vin": "3N1AB8CVXMY314161", "price": 17396, "miles": 38058, "dom": 138, "dom_180": 138, "dom_active": 138, "dos_active": 138, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocg02507/", "dealer_id": 11023909, "mc_website_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "dist": 0.15 } ], "stats": { "price": { "min": 12900, "max": 19997, "count": 36, "missing": 0, "sum": 599013, "mean": 16639.25, "stddev": 1473.78, "sum_of_squares": 10045319521, "median": 16895, "percentiles": { "5.0": 14520.5, "25.0": 15870.75, "50.0": 16895, "75.0": 17411.25, "90.0": 18198.5, "95.0": 19220, "99.0": 19961.3 } }, "miles": { "min": 453, "max": 101156, "count": 36, "missing": 0, "sum": 1410660, "mean": 39185, "stddev": 23857.75, "sum_of_squares": 75767635530, "median": 36607.5, "percentiles": { "5.0": 5499.25, "25.0": 21861.5, "50.0": 36607.5, "75.0": 61406.5, "90.0": 70911.5, "95.0": 74427, "99.0": 91827.1 } }, "dos_active": { "min": 1, "max": 235, "count": 36, "missing": 0, "sum": 1785, "mean": 49.58, "stddev": 50.29, "sum_of_squares": 179557, "median": 36, "percentiles": { "5.0": 1.75, "25.0": 12, "50.0": 36, "75.0": 73.75, "90.0": 112.5, "95.0": 133.5, "99.0": 201.05 } } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/ca/marketcheck_price/comparables/decode": { "get": { "operationId": "predictCarCaMarketcheckPriceComparablesDecode", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 18518, "msrp": 23968, "decode": { "vin": "3N1AB8CV6MY314187", "squish_vin": "3N1AB8CV_MY", "year": 2021, "make": "Nissan", "model": "Sentra", "vehicle_type": "Car", "trim": "SV", "trim_confidence": "mc_build_specs|heading|exact_match", "version": "SV CVT", "version_confidence": "single|latest", "transmission": "CVT", "transmission_confidence": "mc_build_specs|cf_mechanical_features|exact_match", "record_confidence": 100, "record_source": "partial_build_specs", "drivetrain": "FWD", "powertrain_type": "Combustion", "engine": "2.0L I4", "fuel_type": "Unleaded", "doors": 4, "body_type": "Sedan", "width": 71.5, "height": 59.5, "length": 183.3, "city_mpg": 36, "highway_mpg": 48, "manufacturer_code": "C4SG11", "msrp": 22298, "mc_msrp": 24868, "build_specs_msrp": 24868, "original_msrp": 20570, "delivery_charges": 1670, "installed_options_msrp": 0, "combined_msrp": 23968, "exterior_color": { "code": "KH3", "name": "Super Black", "msrp": "0", "confidence": "1.0", "base": "Black" }, "country": "CA", "seating_capacity": 5, "combined_mpg": 40, "rating": { "safety": { "front": 4, "side": 5, "overall": 5 }, "rollover": 5, "roof_strength": "Good" }, "warranty": { "total": { "duration": 36, "distance": 37282 }, "powertrain": { "duration": 60, "distance": 62137 }, "anti_corrosion": { "duration": 60, "distance": 9999999 }, "roadside_assistance": { "duration": 36, "distance": 9999999 } }, "installed_options_details": [], "features": { "STANDARD": [ { "category": "Infotainment", "feature_type": "Audio Speakers", "description": "6 Speakers" }, { "category": "Exterior", "feature_type": "Headlight Lens Type", "description": "Complex Surface Headlights" } ] }, "high_value_features": { "STANDARD": [ { "category": "Infotainment", "description": "Premium Speakers" }, { "category": "Comfort & Convenience", "description": "Advanced Headlight Control Functions" } ] }, "installed_equipment": { "STANDARD": [ { "category": "Pricing", "item": "Secondary Price currency", "attribute": "Secondary Price currency", "location": "", "value": "euro" }, { "category": "Pricing", "item": "Secondary MSRP", "attribute": "Secondary MSRP", "location": "", "value": "13914.51" } ] }, "created_at": 1783145947, "created_at_date": "2026-07-04T06:19:07.000Z", "updated_at": 1783145947, "updated_at_date": "2026-07-04T06:19:07.000Z", "decode_version": 1 }, "comparables": { "num_found": 20, "listings": [ { "id": "3N1AB8CV6MY314187-dbbd68ac-518b", "vin": "3N1AB8CV6MY314187", "price": 19895, "miles": 35490, "dom": 206, "dom_180": 149, "dom_active": 12, "dos_active": 12, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocs02236/", "photo_url": "https://evalauto-resources.s3.us-east-2.amazonaws.com/concession/QC/42/cars/249990/thumbnails/medium/19a9355a1d49b0692.13325171.jpg", "dealer_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "mc_website_id": 11023909, "dist": 0.15 }, { "id": "3N1AB8CV8MY301568-76b201ec-cc5c", "vin": "3N1AB8CV8MY301568", "price": 16995, "miles": 16586, "dom": 10, "dom_180": 10, "dom_active": 10, "dos_active": 10, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "http://www.coupalbrassardnissan.com/en/used-inventory/Nissan/SENTRA/2021-Nissan-SENTRA-id38746875", "dealer_id": 1099683, "dealer_name": "Coupal Brassard Nissan St-jean", "latitude": "45.327774", "longitude": "-73.28661", "mc_website_id": 1099683, "dist": 62.31 } ], "stats": { "price": { "min": 9999, "max": 19895, "count": 20, "missing": 0, "sum": 336575, "mean": 16828.75, "stddev": 2226.15, "sum_of_squares": 5763251309, "median": 16998, "percentiles": { "5.0": 13693.55, "25.0": 15552.25, "50.0": 16998, "75.0": 18812.5, "90.0": 18995, "95.0": 19040, "99.0": 19724 } }, "miles": { "min": 16419, "max": 120645, "count": 20, "missing": 0, "sum": 957911, "mean": 47895.55, "stddev": 24159.82, "sum_of_squares": 57553612959, "median": 42575.5, "percentiles": { "5.0": 16577.65, "25.0": 34347.25, "50.0": 42575.5, "75.0": 61034, "90.0": 73544.1, "95.0": 79482.45, "99.0": 112412.49 } }, "dos_active": { "min": 2, "max": 215, "count": 20, "missing": 0, "sum": 700, "mean": 35, "stddev": 54.15, "sum_of_squares": 83134, "median": 14, "percentiles": { "5.0": 2, "25.0": 8.25, "50.0": 14, "75.0": 31.25, "90.0": 69.5, "95.0": 166.55, "99.0": 205.31 } } } }, "recent_comparables": { "num_found": 36, "listings": [ { "id": "3N1AB8CV6MY314187-9a9f4511-193d", "vin": "3N1AB8CV6MY314187", "price": 19895, "miles": 35489, "dom": 197, "dom_180": 140, "dom_active": 3, "dos_active": 3, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocs02236/", "dealer_id": 11023909, "mc_website_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "dist": 0.15 }, { "id": "3N1AB8CVXMY314161-f3eb8273-464a", "vin": "3N1AB8CVXMY314161", "price": 17396, "miles": 38058, "dom": 138, "dom_180": 138, "dom_active": 138, "dos_active": 138, "year": 2021, "make": "Nissan", "model": "Sentra", "trim": "SV", "vdp_url": "https://www.occasionbeaucage.com/en/used-car/nissan-sentra-sv-2021-ocg02507/", "dealer_id": 11023909, "mc_website_id": 11023909, "dealer_name": "Occasion Beaucage Sherbrooke", "latitude": "45.364877", "longitude": "-72.001526", "dist": 0.15 } ], "stats": { "price": { "min": 12900, "max": 19997, "count": 36, "missing": 0, "sum": 599013, "mean": 16639.25, "stddev": 1473.78, "sum_of_squares": 10045319521, "median": 16895, "percentiles": { "5.0": 14520.5, "25.0": 15870.75, "50.0": 16895, "75.0": 17411.25, "90.0": 18198.5, "95.0": 19220, "99.0": 19961.3 } }, "miles": { "min": 453, "max": 101156, "count": 36, "missing": 0, "sum": 1410660, "mean": 39185, "stddev": 23857.75, "sum_of_squares": 75767635530, "median": 36607.5, "percentiles": { "5.0": 5499.25, "25.0": 21861.5, "50.0": 36607.5, "75.0": 61406.5, "90.0": 70911.5, "95.0": 74427, "99.0": 91827.1 } }, "dos_active": { "min": 1, "max": 235, "count": 36, "missing": 0, "sum": 1785, "mean": 49.58, "stddev": 50.29, "sum_of_squares": 179557, "median": 36, "percentiles": { "5.0": 1.75, "25.0": 12, "50.0": 36, "75.0": 73.75, "90.0": 112.5, "95.0": 133.5, "99.0": 201.05 } } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/uk/marketcheck_price": { "get": { "operationId": "predictCarUkMarketcheckPrice", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "UK Cars / Market Insights" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/vrm" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/postal_code_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 7964 } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/uk/marketcheck_price/comparables": { "get": { "operationId": "predictCarUkMarketcheckPriceComparables", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "UK Cars / Market Insights" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/vrm" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/postal_code_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 7964, "comparables": { "num_found": 6, "listings": [ { "id": "7be1ba59c7e6ebedb22f24ab523dc5844c4a0ab1b8ab8df8bc8ba666cca48d90", "vehicle_registration_mark": "YR17CYY", "price": 7250, "miles": 66609, "dom": 130, "dom_180": 130, "dom_active": 130, "dos_active": 130, "year": 2017, "make": "Mitsubishi", "model": "ASX", "trim": "2", "vdp_url": "https://www.allrightautos.co.uk/used/mitsubishi/asx/16-2-5dr/hull/east-yorkshire/21566201", "photo_url": "https://www.allrightautos.co.uk/media/images/192965122/p0.mitsubishi-asx-petrol-hatchback.jpg", "dealer_id": 10040997, "dealer_name": "All Right Autos", "latitude": "53.77587", "longitude": "-0.385988", "mc_website_id": 10040997 }, { "id": "9113ee4f517b08973c8ca0581c46bd6c1ba2669271efeb90ddb31968c5a75e00", "vehicle_registration_mark": "DU67UKK", "price": 8995, "miles": 37671, "dom": 48, "dom_180": 48, "dom_active": 48, "dos_active": 48, "year": 2017, "make": "Mitsubishi", "model": "ASX", "trim": "2", "vdp_url": "https://jdmotorco.co.uk/vehicle/name/mitsubishi-asx-2-2/", "photo_url": "https://aacarsdna.com/images/vehicles/97/large/569d60ec0f612ce0c325e4e0439a5c26.jpg", "dealer_id": 10024934, "dealer_name": "JD Motor Co (Mansfield) Ltd", "latitude": "53.164812", "longitude": "-1.186753", "mc_website_id": 10024934 } ], "stats": { "price": { "min": 5490, "max": 9990, "count": 6, "missing": 0, "sum": 47120, "mean": 7853.33, "stddev": 1416.79, "sum_of_squares": 382092750, "median": 7697.5, "percentiles": { "5.0": 5930, "25.0": 7287.5, "50.0": 7697.5, "75.0": 8745, "90.0": 9492.5, "95.0": 9741.25, "99.0": 9940.25 } }, "miles": { "min": 20913, "max": 95401, "count": 6, "missing": 0, "sum": 340642, "mean": 56773.67, "stddev": 24096.11, "sum_of_squares": 22823229142, "median": 58038, "percentiles": { "5.0": 25102.5, "25.0": 40620, "50.0": 58038, "75.0": 69588, "90.0": 82991, "95.0": 89196, "99.0": 94160 } }, "dos_active": { "min": 2, "max": 130, "count": 6, "missing": 0, "sum": 344, "mean": 57.33, "stddev": 53.18, "sum_of_squares": 36694, "median": 33.5, "percentiles": { "5.0": 5.25, "25.0": 16, "50.0": 33.5, "75.0": 109.5, "90.0": 130, "95.0": 130, "99.0": 130 } } } }, "recent_comparables": { "num_found": 10, "listings": [ { "id": "d269a0a53506a3ac934d242580aff10a3497b8393f613b35425eba554e252081", "price": 7400, "miles": 52717, "dom": 65, "dom_180": 65, "dom_active": 65, "dos_active": 65, "year": 2017, "make": "Mitsubishi", "model": "ASX", "variant": "2", "vdp_url": "http://surreyspecialistcars.co.uk/used-mitsubishi-asx-guildford-surrey-6967421", "dealer_id": 11002776, "mc_website_id": 11002776, "dealer_name": "Surrey Specialist Cars", "latitude": "51.143155", "longitude": "-0.498773", "vehicle_registration_mark": "DK17WPF" }, { "id": "e5546d10444c244a66e051be8e447c425d44dabfbecf6c52cbe1315c0258d8a3", "price": 7995, "miles": 63527, "dom": 66, "dom_180": 66, "dom_active": 66, "dos_active": 66, "year": 2017, "make": "Mitsubishi", "model": "ASX", "variant": "2", "vdp_url": "https://www.herefordmotorgroup.co.uk/used/54d4452c-f386-4c6c-adf0-3b2b598d3fef", "dealer_id": 10039376, "mc_website_id": 10039376, "dealer_name": "Hereford Motor Group", "latitude": "52.067801", "longitude": "-2.764259", "vehicle_registration_mark": "CV67BJZ" } ], "stats": { "price": { "min": 6995, "max": 9325, "count": 10, "missing": 0, "sum": 79844, "mean": 7984.4, "stddev": 666.4, "sum_of_squares": 641947276, "median": 7922.5, "percentiles": { "5.0": 7177.25, "25.0": 7570, "50.0": 7922.5, "75.0": 7995, "90.0": 9031.6, "95.0": 9178.3, "99.0": 9295.66 } }, "miles": { "min": 32256, "max": 83445, "count": 10, "missing": 0, "sum": 544946, "mean": 54494.6, "stddev": 13447.59, "sum_of_squares": 31504991446, "median": 52858.5, "percentiles": { "5.0": 36383.85, "25.0": 46338.25, "50.0": 52858.5, "75.0": 62242.75, "90.0": 65518.8, "95.0": 74481.9, "99.0": 81652.38 } }, "dos_active": { "min": 7, "max": 121, "count": 10, "missing": 0, "sum": 456, "mean": 45.6, "stddev": 36.13, "sum_of_squares": 33846, "median": 40.5, "percentiles": { "5.0": 7, "25.0": 12.25, "50.0": 40.5, "75.0": 65.75, "90.0": 85.9, "95.0": 103.45, "99.0": 117.49 } } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/us/marketcheck_price": { "get": { "operationId": "predictCarUsMarketcheckPrice", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 29014, "msrp": 38000 } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/us/marketcheck_price/comparables": { "get": { "operationId": "predictCarUsMarketcheckPriceComparables", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 29014, "msrp": 38000, "comparables": { "num_found": 114, "listings": [ { "id": "2T3DWRFV8LW066769-2ff186d0-5aab", "vin": "2T3DWRFV8LW066769", "price": 29101, "miles": 79372, "dom": 119, "dom_180": 16, "dom_active": 16, "dos_active": 16, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.autonationsubaruwest.com/used/Toyota/2020-Toyota-RAV4-Hybrid-denver-bd389588ac184763ed48d454616e812f.htm", "photo_url": "https://pictures.dealer.com/g/gosubaruwestsoa/1933/2aecf3a517c6c78357dde267ef754053x.jpg", "dealer_id": 1012339, "dealer_name": "Autonation Subaru West", "latitude": "39.728121", "longitude": "-105.18374", "mc_website_id": 1012339, "dist": 3.78 }, { "id": "JTMD6RFV8LD006441-d85a89c7-3d04", "vin": "JTMD6RFV8LD006441", "price": 31732, "miles": 49727, "dom": 59, "dom_180": 41, "dom_active": 41, "dos_active": 41, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.omearagmc.com/used/Toyota/2020-Toyota-RAV4-3b930995ac1847eae08c29d8c92267c3.htm", "photo_url": "https://pictures.dealer.com/o/omearabuickgmcgmc/0051/ce5c6023b1abd80d164e121ce975c7a1x.jpg", "dealer_id": 1010035, "dealer_name": "O'meara Gmc", "latitude": "39.884232", "longitude": "-105.011271", "mc_website_id": 1010035, "dist": 11.12 } ], "stats": { "price": { "min": 22672, "max": 39995, "count": 114, "missing": 0, "sum": 3434983, "mean": 30131.43, "stddev": 3534.12, "sum_of_squares": 104924810213, "median": 29980, "percentiles": { "5.0": 24500, "25.0": 27568.5, "50.0": 29980, "75.0": 32995.25, "90.0": 33995, "95.0": 35802.6, "99.0": 38339.76 } }, "miles": { "min": 14316, "max": 152254, "count": 114, "missing": 0, "sum": 7050387, "mean": 61845.5, "stddev": 29797.66, "sum_of_squares": 537255373337, "median": 53374.5, "percentiles": { "5.0": 20207.8, "25.0": 40620, "50.0": 53374.5, "75.0": 83034, "90.0": 99647.1, "95.0": 117179.75, "99.0": 137443.7 } }, "dos_active": { "min": 1, "max": 856, "count": 114, "missing": 0, "sum": 6297, "mean": 55.24, "stddev": 90.64, "sum_of_squares": 1284419, "median": 35, "percentiles": { "5.0": 4, "25.0": 13.25, "50.0": 35, "75.0": 61, "90.0": 102.7, "95.0": 149.15, "99.0": 288.75 } } } }, "recent_comparables": { "num_found": 19, "listings": [ { "id": "JTMD6RFV7LD004020-9bcef59d-6e02", "vin": "JTMD6RFV7LD004020", "price": 31699, "miles": 54414, "dom": 27, "dom_180": 22, "dom_active": 22, "dos_active": 22, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.stevinsonauto.com/inventory/used-2020-toyota-rav4-hybrid-limited-awd-sport-utility-jtmd6rfv7ld004020/", "dealer_id": 1012345, "mc_website_id": 1012345, "dealer_name": "Stevinson Automotive", "latitude": "39.737587", "longitude": "-105.157602" }, { "id": "2T3DWRFV8LW066769-aca000f3-bb66", "vin": "2T3DWRFV8LW066769", "price": 29499, "miles": 79372, "dom": 118, "dom_180": 15, "dom_active": 15, "dos_active": 15, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.autonationsubaruwest.com/used/Toyota/2020-Toyota-RAV4-Hybrid-denver-bd389588ac184763ed48d454616e812f.htm", "dealer_id": 1012339, "mc_website_id": 1012339, "dealer_name": "Autonation Subaru West", "latitude": "39.728121", "longitude": "-105.18374" } ], "stats": { "price": { "min": 24455, "max": 34998, "count": 19, "missing": 0, "sum": 578909, "mean": 30468.89, "stddev": 2905.72, "sum_of_squares": 17799138893, "median": 30998, "percentiles": { "5.0": 25395.5, "25.0": 29193.5, "50.0": 30998, "75.0": 32299.5, "90.0": 33651, "95.0": 34908.9, "99.0": 34980.18 } }, "miles": { "min": 33948, "max": 113864, "count": 19, "missing": 0, "sum": 1216628, "mean": 64033.05, "stddev": 22675.49, "sum_of_squares": 87673785130, "median": 60786, "percentiles": { "5.0": 37205.1, "25.0": 45272, "50.0": 60786, "75.0": 78484, "90.0": 92340.4, "95.0": 109146.2, "99.0": 112920.44 } }, "dos_active": { "min": 3, "max": 176, "count": 19, "missing": 0, "sum": 720, "mean": 37.89, "stddev": 37.21, "sum_of_squares": 53594, "median": 34, "percentiles": { "5.0": 4.8, "25.0": 16.5, "50.0": 34, "75.0": 47.5, "90.0": 58.8, "95.0": 73.4, "99.0": 155.48 } } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/predict/car/us/marketcheck_price/comparables/decode": { "get": { "operationId": "predictCarUsMarketcheckPriceComparablesDecode", "summary": "MarketCheck Price™: API Tiers & Endpoints", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/marketcheck-price" }, "parameters": [ { "$ref": "#/components/parameters/city_v3" }, { "$ref": "#/components/parameters/dealer_type_v2" }, { "$ref": "#/components/parameters/is_certified" }, { "$ref": "#/components/parameters/miles" }, { "$ref": "#/components/parameters/state_v4" }, { "$ref": "#/components/parameters/vin_v2" }, { "$ref": "#/components/parameters/zip_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "marketcheck_price": 29014, "msrp": 38000, "decode": { "vin": "2T3DWRFV3LW077677", "squish_vin": "2T3DWRFV_LW", "year": 2020, "make": "Toyota", "model": "RAV4", "vehicle_type": "Truck", "listing_confidence": "mc_listings|used|dealer|independent|56479|alt_opts", "trim": "Limited", "trim_confidence": "spec_data", "version": "Hybrid Limited AWD", "version_confidence": "single", "transmission": "CVT", "transmission_confidence": "superseded", "transmission_description": "Continuously Trans With Manual Mode", "drivetrain": "4WD", "powertrain_type": "HEV", "engine": "2.5L I4", "fuel_type": "Electric / Unleaded", "doors": 5, "body_type": "SUV", "weight": 4920, "width": 73, "height": 67, "length": 180.9, "city_mpg": 41, "highway_mpg": 38, "manufacturer_code": "4454", "msrp": 36880, "delivery_charges": 1120, "installed_options_msrp": 0, "combined_msrp": 38000, "interior_color": { "code": "EA40", "name": "Nutmeg SofTex", "confidence": "0.67", "base": "Beige" }, "exterior_color": { "code": "218", "name": "Midnight Black Metallic", "msrp": "0", "confidence": "0.36", "base": "Black" }, "country": "USA", "seating_capacity": 5, "combined_mpg": 40, "rating": { "safety": { "front": 4, "side": 5, "overall": 5 }, "rollover": 4, "roof_strength": "Good" }, "warranty": { "total": { "duration": 36, "distance": 36000 }, "powertrain": { "duration": 60, "distance": 60000 }, "anti_corrosion": { "duration": 60, "distance": 999999 }, "roadside_assistance": { "duration": 24, "distance": 999999 } }, "installed_options_details": [], "features": { "STANDARD": [ { "category": "Comfort & Convenience", "feature_type": "Cruise Control", "description": "Adaptive Cruise Control" }, { "category": "Comfort & Convenience", "feature_type": "Cruise Control", "description": "Cruise Control" } ] }, "high_value_features": { "STANDARD": [ { "category": "Comfort & Convenience", "description": "Adaptive Cruise Control" }, { "category": "Exterior", "description": "Upgrade Paint" } ] }, "installed_equipment": { "STANDARD": [ { "category": "Safety & Driver Assist", "item": "Stability control", "attribute": "Stability control", "location": "", "value": "standard" }, { "category": "Safety & Driver Assist", "item": "Electronic brake distribution", "attribute": "Electronic brake distribution", "location": "", "value": "standard" } ] }, "created_at": 1737270335, "created_at_date": "2025-01-19T07:05:35.000Z", "updated_at": 1737270335, "updated_at_date": "2025-01-19T07:05:35.000Z", "decode_version": 1 }, "comparables": { "num_found": 114, "listings": [ { "id": "2T3DWRFV8LW066769-2ff186d0-5aab", "vin": "2T3DWRFV8LW066769", "price": 29101, "miles": 79372, "dom": 119, "dom_180": 16, "dom_active": 16, "dos_active": 16, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.autonationsubaruwest.com/used/Toyota/2020-Toyota-RAV4-Hybrid-denver-bd389588ac184763ed48d454616e812f.htm", "photo_url": "https://pictures.dealer.com/g/gosubaruwestsoa/1933/2aecf3a517c6c78357dde267ef754053x.jpg", "dealer_id": 1012339, "dealer_name": "Autonation Subaru West", "latitude": "39.728121", "longitude": "-105.18374", "mc_website_id": 1012339, "dist": 3.78 }, { "id": "JTMD6RFV8LD006441-d85a89c7-3d04", "vin": "JTMD6RFV8LD006441", "price": 31732, "miles": 49727, "dom": 59, "dom_180": 41, "dom_active": 41, "dos_active": 41, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.omearagmc.com/used/Toyota/2020-Toyota-RAV4-3b930995ac1847eae08c29d8c92267c3.htm", "photo_url": "https://pictures.dealer.com/o/omearabuickgmcgmc/0051/ce5c6023b1abd80d164e121ce975c7a1x.jpg", "dealer_id": 1010035, "dealer_name": "O'meara Gmc", "latitude": "39.884232", "longitude": "-105.011271", "mc_website_id": 1010035, "dist": 11.12 } ], "stats": { "price": { "min": 22672, "max": 39995, "count": 114, "missing": 0, "sum": 3434983, "mean": 30131.43, "stddev": 3534.12, "sum_of_squares": 104924810213, "median": 29980, "percentiles": { "5.0": 24500, "25.0": 27568.5, "50.0": 29980, "75.0": 32995.25, "90.0": 33995, "95.0": 35802.6, "99.0": 38339.76 } }, "miles": { "min": 14316, "max": 152254, "count": 114, "missing": 0, "sum": 7050387, "mean": 61845.5, "stddev": 29797.66, "sum_of_squares": 537255373337, "median": 53374.5, "percentiles": { "5.0": 20207.8, "25.0": 40620, "50.0": 53374.5, "75.0": 83034, "90.0": 99647.1, "95.0": 117179.75, "99.0": 137443.7 } }, "dos_active": { "min": 1, "max": 856, "count": 114, "missing": 0, "sum": 6297, "mean": 55.24, "stddev": 90.64, "sum_of_squares": 1284419, "median": 35, "percentiles": { "5.0": 4, "25.0": 13.25, "50.0": 35, "75.0": 61, "90.0": 102.7, "95.0": 149.15, "99.0": 288.75 } } } }, "recent_comparables": { "num_found": 19, "listings": [ { "id": "JTMD6RFV7LD004020-9bcef59d-6e02", "vin": "JTMD6RFV7LD004020", "price": 31699, "miles": 54414, "dom": 27, "dom_180": 22, "dom_active": 22, "dos_active": 22, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.stevinsonauto.com/inventory/used-2020-toyota-rav4-hybrid-limited-awd-sport-utility-jtmd6rfv7ld004020/", "dealer_id": 1012345, "mc_website_id": 1012345, "dealer_name": "Stevinson Automotive", "latitude": "39.737587", "longitude": "-105.157602" }, { "id": "2T3DWRFV8LW066769-aca000f3-bb66", "vin": "2T3DWRFV8LW066769", "price": 29499, "miles": 79372, "dom": 118, "dom_180": 15, "dom_active": 15, "dos_active": 15, "year": 2020, "make": "Toyota", "model": "RAV4", "trim": "Limited", "vdp_url": "https://www.autonationsubaruwest.com/used/Toyota/2020-Toyota-RAV4-Hybrid-denver-bd389588ac184763ed48d454616e812f.htm", "dealer_id": 1012339, "mc_website_id": 1012339, "dealer_name": "Autonation Subaru West", "latitude": "39.728121", "longitude": "-105.18374" } ], "stats": { "price": { "min": 24455, "max": 34998, "count": 19, "missing": 0, "sum": 578909, "mean": 30468.89, "stddev": 2905.72, "sum_of_squares": 17799138893, "median": 30998, "percentiles": { "5.0": 25395.5, "25.0": 29193.5, "50.0": 30998, "75.0": 32299.5, "90.0": 33651, "95.0": 34908.9, "99.0": 34980.18 } }, "miles": { "min": 33948, "max": 113864, "count": 19, "missing": 0, "sum": 1216628, "mean": 64033.05, "stddev": 22675.49, "sum_of_squares": 87673785130, "median": 60786, "percentiles": { "5.0": 37205.1, "25.0": 45272, "50.0": 60786, "75.0": 78484, "90.0": 92340.4, "95.0": 109146.2, "99.0": 112920.44 } }, "dos_active": { "min": 3, "max": 176, "count": 19, "missing": 0, "sum": 720, "mean": 37.89, "stddev": 37.21, "sum_of_squares": 53594, "median": 34, "percentiles": { "5.0": 4.8, "25.0": 16.5, "50.0": 34, "75.0": 47.5, "90.0": 58.8, "95.0": 73.4, "99.0": 155.48 } } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/sales/car": { "get": { "operationId": "salesCar", "summary": "Inferred Sales Stats", "tags": [ "Cars / Market Insights" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/market-insights/inferred-sales-stats" }, "parameters": [ { "$ref": "#/components/parameters/make_v2" }, { "$ref": "#/components/parameters/mm" }, { "$ref": "#/components/parameters/ymm" }, { "$ref": "#/components/parameters/ymmt_v2" }, { "$ref": "#/components/parameters/taxonomy_vin" }, { "$ref": "#/components/parameters/vin_v3" }, { "$ref": "#/components/parameters/state_v5" }, { "$ref": "#/components/parameters/city_state_v2" }, { "$ref": "#/components/parameters/country_v5" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "count": 800637, "cpo": 0, "non_cpo": 800637, "inventory_type": "new", "make": "Toyota", "dom_stats": { "geometric_mean": 27, "min": 1, "median": 29, "population_standard_deviation": 36, "variance": 1227, "max": 3033, "mean": 36, "trimmed_mean": 30, "standard_deviation": 36, "iqr": 23 }, "price_stats": { "geometric_mean": 41467, "min": 5551, "median": 40299, "population_standard_deviation": 13426, "variance": 180232107, "max": 247096, "mean": 43387, "trimmed_mean": 42220, "standard_deviation": 13426, "iqr": 18440 }, "miles_stats": { "geometric_mean": 6, "min": 1, "median": 5, "population_standard_deviation": 3428, "variance": 11747937, "max": 967000, "mean": 112, "trimmed_mean": 6, "standard_deviation": 3428, "iqr": 7 } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/active": { "get": { "operationId": "searchCarActive", "summary": "Inventory Search", "tags": [ "Cars / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/carfax_1_owner" }, { "$ref": "#/components/parameters/carfax_clean_title" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_high_value_features" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_options_packages" }, { "$ref": "#/components/parameters/exclude_sources" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/finance_down_payment" }, { "$ref": "#/components/parameters/finance_down_payment_per" }, { "$ref": "#/components/parameters/finance_emp" }, { "$ref": "#/components/parameters/finance_loan_apr" }, { "$ref": "#/components/parameters/finance_loan_term" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/high_value_features" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_finance" }, { "$ref": "#/components/parameters/include_lease" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_preferred_dealer_flag" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_down_payment" }, { "$ref": "#/components/parameters/lease_emp" }, { "$ref": "#/components/parameters/lease_term" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/mm_v2" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/nodedup" }, { "$ref": "#/components/parameters/options_packages" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/powertrain_type" }, { "$ref": "#/components/parameters/preferred_dealers" }, { "$ref": "#/components/parameters/preferred_dealers_only" }, { "$ref": "#/components/parameters/price_change" }, { "$ref": "#/components/parameters/price_change_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/taxonomy_vins" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/version" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/vins" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymm_v2" }, { "$ref": "#/components/parameters/ymmt" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/vehicle_status" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 6517, "listings": [], "stats": { "dom": { "min": 1, "max": 993, "count": 6517, "missing": 0, "sum": 1018662, "mean": 156.31, "stddev": 156.93, "sum_of_squares": 319711024, "median": 106.05, "percentiles": { "5.0": 13.15, "25.0": 54.98, "50.0": 106.05, "75.0": 195.43, "90.0": 364.44, "95.0": 528.28, "99.0": 716.99 } }, "dom_active": { "min": 1, "max": 993, "count": 6517, "missing": 0, "sum": 624198, "mean": 95.78, "stddev": 140.22, "sum_of_squares": 187924224, "median": 49.15, "percentiles": { "5.0": 5.23, "25.0": 17.53, "50.0": 49.15, "75.0": 103.17, "90.0": 234.32, "95.0": 422.75, "99.0": 680.39 } }, "dos_active": { "min": 1, "max": 973, "count": 6517, "missing": 0, "sum": 510211, "mean": 78.29, "stddev": 125.8, "sum_of_squares": 143085717, "median": 40.27, "percentiles": { "5.0": 4.51, "25.0": 15.67, "50.0": 40.27, "75.0": 82.85, "90.0": 145, "95.0": 359.43, "99.0": 646.76 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/auction/active": { "get": { "operationId": "searchCarAuctionActive", "summary": "Auction Search", "tags": [ "Cars / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/inventory/auction-search" }, "parameters": [ { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/buy_now_price_range" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/carfax_1_owner" }, { "$ref": "#/components/parameters/carfax_clean_title" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_high_value_features" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_options_packages" }, { "$ref": "#/components/parameters/exclude_sources" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/finance_down_payment" }, { "$ref": "#/components/parameters/finance_down_payment_per" }, { "$ref": "#/components/parameters/finance_emp" }, { "$ref": "#/components/parameters/finance_loan_apr" }, { "$ref": "#/components/parameters/finance_loan_term" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/high_value_features" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_finance" }, { "$ref": "#/components/parameters/include_lease" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_down_payment" }, { "$ref": "#/components/parameters/lease_emp" }, { "$ref": "#/components/parameters/lease_term" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/mm_v2" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/nodedup" }, { "$ref": "#/components/parameters/options_packages" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/powertrain_type" }, { "$ref": "#/components/parameters/price_change" }, { "$ref": "#/components/parameters/price_change_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/taxonomy_vins" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/version" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/vins" }, { "$ref": "#/components/parameters/vehicle_status" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymm_v2" }, { "$ref": "#/components/parameters/ymmt" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1015, "listings": [ { "id": "WP0CA29805L001248-28ed8a55-0e6c", "vin": "WP0CA29805L001248", "price": 1595000, "msrp": 1595000, "data_source": "mc", "vdp_url": "https://www.barrett-jackson.com/scottsdale-2023/docket/vehicle/2005-porsche-carrera-gt-260968", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "RED", "interior_color": "DARK GRAY", "base_int_color": "Gray", "base_ext_color": "Red", "dom": 157, "dom_180": 104, "dom_active": 104, "dos_active": 104, "seller_type": "auction", "inventory_type": "used", "last_seen_at": 1752937382, "last_seen_at_date": "2025-07-19T15:03:02.000Z", "scraped_at": 1744027162, "scraped_at_date": "2025-04-07T11:59:22.000Z", "first_seen_at": 1744027162, "first_seen_at_date": "2025-04-07T11:59:22.000Z", "first_seen_at_source": 1744027162, "first_seen_at_source_date": "2025-04-07T11:59:22.000Z", "first_seen_at_mc": 1490715392, "first_seen_at_mc_date": "2017-03-28T15:36:32.000Z", "source": "barrett-jackson.com", "in_transit": false, "media": { "photo_links": [ "https://www.barrett-jackson.com/_next/image?url=https://BarrettJacksonCDN.azureedge.net/staging/carlist/items/fullsize/cars/260968/260968_Front_3-4_Web.jpg&w=3840&q=75", "https://www.barrett-jackson.com/_next/image?url=https://BarrettJacksonCDN.azureedge.net/staging/carlist/items/fullsize/cars/260968/260968_Rear_3-4_Web.jpg&w=3840&q=75" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/WP0CA29805L001248-28ed8a55-0e6c/98fe53d96905328fd40ae0c7b008002c?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/WP0CA29805L001248-28ed8a55-0e6c/5e26e007c17a11abf92befacce029d88?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 11040571, "website": "barrett-jackson.com", "name": "Barrett-Jackson Auction Company, LLC.", "dealer_type": "independent", "street": "15555 North 79th Place #a", "city": "Scottsdale", "state": "AZ", "country": "US", "latitude": "33.626939", "longitude": "-111.908514", "zip": "85260", "msa_code": "6200", "phone": "480-421-6697" }, "mc_dealership": { "mc_website_id": 11040571, "mc_dealer_id": 1206485, "mc_location_id": 1585799, "mc_rooftop_id": 580528, "mc_category": "Auction", "website": "barrett-jackson.com", "name": "Barrett-Jackson Auction Company, LLC.", "dealer_type": "independent", "street": "15555 North 79th Place #a", "city": "Scottsdale", "state": "AZ", "country": "US", "latitude": "33.626939", "longitude": "-111.908514", "zip": "85260", "msa_code": "6200", "phone": "480-421-6697" }, "build": { "year": 2005, "make": "Porsche", "model": "Carrera GT", "trim": "Base", "version": "-", "body_type": "Targa", "vehicle_type": "Car", "transmission": "Manual", "drivetrain": "RWD", "fuel_type": "Premium Unleaded", "engine": "5.7L V10", "engine_size": 5.7, "engine_block": "V", "doors": 2, "cylinders": 10, "made_in": "USA", "overall_height": "45.9", "overall_length": "181.6", "overall_width": "75.6", "std_seating": "2", "highway_mpg": 20, "city_mpg": 8 } }, { "id": "SBM12ABA6FW000236-316571c6-51a9", "vin": "SBM12ABA6FW000236", "price": 1567500, "msrp": 1567500, "data_source": "mc", "vdp_url": "https://www.barrett-jackson.com/las-vegas-2021/docket/vehicle/dj-deadmau5s-2015-mclaren-p1-248184", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "BLUE", "interior_color": "BLACK", "base_int_color": "Black", "base_ext_color": "Blue", "dom": 490, "dom_180": 104, "dom_active": 104, "dos_active": 104, "seller_type": "auction", "inventory_type": "used", "last_seen_at": 1752939099, "last_seen_at_date": "2025-07-19T15:31:39.000Z", "scraped_at": 1744037229, "scraped_at_date": "2025-04-07T14:47:09.000Z", "first_seen_at": 1744037229, "first_seen_at_date": "2025-04-07T14:47:09.000Z", "first_seen_at_source": 1744037229, "first_seen_at_source_date": "2025-04-07T14:47:09.000Z", "first_seen_at_mc": 1621611691, "first_seen_at_mc_date": "2021-05-21T15:41:31.000Z", "source": "barrett-jackson.com", "in_transit": false, "media": { "photo_links": [ "https://www.barrett-jackson.com/_next/image?url=https://BarrettJacksonCDN.azureedge.net/staging/carlist/items/fullsize/cars/248184/248184_Front_3-4_Web.jpg&w=3840&q=75", "https://www.barrett-jackson.com/_next/image?url=https://BarrettJacksonCDN.azureedge.net/staging/carlist/items/fullsize/cars/248184/248184_Rear_3-4_Web.jpg&w=3840&q=75" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/SBM12ABA6FW000236-316571c6-51a9/357e3da4d3773ff5b3d7da19f2109f98?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/SBM12ABA6FW000236-316571c6-51a9/7060d882dcf059ab2ffaa8934072a330?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 11040571, "website": "barrett-jackson.com", "name": "Barrett-Jackson Auction Company, LLC.", "dealer_type": "independent", "street": "15555 North 79th Place #a", "city": "Scottsdale", "state": "AZ", "country": "US", "latitude": "33.626939", "longitude": "-111.908514", "zip": "85260", "msa_code": "6200", "phone": "480-421-6697" }, "mc_dealership": { "mc_website_id": 11040571, "mc_dealer_id": 1206485, "mc_location_id": 1585799, "mc_rooftop_id": 580528, "mc_category": "Auction", "website": "barrett-jackson.com", "name": "Barrett-Jackson Auction Company, LLC.", "dealer_type": "independent", "street": "15555 North 79th Place #a", "city": "Scottsdale", "state": "AZ", "country": "US", "latitude": "33.626939", "longitude": "-111.908514", "zip": "85260", "msa_code": "6200", "phone": "480-421-6697" }, "build": { "year": 2015, "make": "McLaren", "model": "P1", "trim": "Base", "version": "-", "body_type": "Coupe", "vehicle_type": "Car", "transmission": "Automatic", "drivetrain": "RWD", "fuel_type": "Electric / Premium Unleaded", "engine": "3.8L V8", "engine_size": 3.8, "engine_block": "V", "doors": 2, "cylinders": 8, "made_in": "USA", "std_seating": "2", "powertrain_type": "PHEV" } } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/auto-complete": { "get": { "operationId": "searchCarAutoComplete", "summary": "Auto-Complete", "tags": [ "Cars / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/inventory/auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_sources" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_min_count" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/seller_type" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/term_counts" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "terms": [ { "item": "F-150", "count": 25687 }, { "item": "F-150 Heritage", "count": 11 } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/fsbo/active": { "get": { "operationId": "searchCarFsboActive", "summary": "Private Party Search", "tags": [ "Cars / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/inventory/private-party-search" }, "parameters": [ { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/carfax_1_owner" }, { "$ref": "#/components/parameters/carfax_clean_title" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_high_value_features" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_options_packages" }, { "$ref": "#/components/parameters/exclude_sources" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/finance_down_payment" }, { "$ref": "#/components/parameters/finance_down_payment_per" }, { "$ref": "#/components/parameters/finance_emp" }, { "$ref": "#/components/parameters/finance_loan_apr" }, { "$ref": "#/components/parameters/finance_loan_term" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/high_value_features" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_finance" }, { "$ref": "#/components/parameters/include_lease" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_down_payment" }, { "$ref": "#/components/parameters/lease_emp" }, { "$ref": "#/components/parameters/lease_term" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/mm_v2" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/nodedup" }, { "$ref": "#/components/parameters/options_packages" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/powertrain_type" }, { "$ref": "#/components/parameters/price_change" }, { "$ref": "#/components/parameters/price_change_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/taxonomy_vins" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/version" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/vins" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymm_v2" }, { "$ref": "#/components/parameters/ymmt" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 33497, "listings": [ { "id": "1HGCP2F61CA214222-8d0aa99c-db15", "vin": "1HGCP2F61CA214222", "heading": "2012 Honda", "price": 9800, "miles": 105040, "msrp": 9800, "data_source": "mc", "vdp_url": "https://www.militarycarlot.com/car/joint-base-mcguire-dix-lakehurst/2012-honda/45685", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "Grey", "base_ext_color": "Gray", "dom": 64, "dom_180": 64, "dom_active": 64, "dos_active": 55, "seller_type": "fsbo", "inventory_type": "used", "last_seen_at": 1750812229, "last_seen_at_date": "2025-06-25T00:43:49.000Z", "scraped_at": 1746199970, "scraped_at_date": "2025-05-02T15:32:50.000Z", "first_seen_at": 1746199970, "first_seen_at_date": "2025-05-02T15:32:50.000Z", "first_seen_at_source": 1746199970, "first_seen_at_source_date": "2025-05-02T15:32:50.000Z", "first_seen_at_mc": 1745436593, "first_seen_at_mc_date": "2025-04-23T19:29:53.000Z", "source": "militarycarlot.com", "in_transit": false, "media": { "photo_links": [ "https://www.militarycarlot.com/sites/default/files/styles/large/public/2025/05/92541/IMG_1538.jpeg?itok=AJb_0nIm", "https://www.militarycarlot.com/sites/default/files/styles/large/public/2025/05/92541/IMG_1539.jpeg?itok=Rf_DBYpP" ], "photo_links_cached": [ "https://api.marketcheck.com/v2/image/cache/car/1HGCP2F61CA214222-8d0aa99c-db15/16f633d3c15e5a74b5f07c195907f2fe?api_key=YOUR_API_KEY", "https://api.marketcheck.com/v2/image/cache/car/1HGCP2F61CA214222-8d0aa99c-db15/e77379220de59c7cd7903773372ac74a?api_key=YOUR_API_KEY" ] }, "dealer": { "id": 11005862, "website": "militarycarlot.com", "name": "Militarycarlot", "dealer_type": "independent", "country": "US" }, "mc_dealership": { "mc_website_id": 11005862, "mc_rooftop_id": 820904, "mc_category": "FSBO", "website": "militarycarlot.com", "name": "Militarycarlot", "dealer_type": "independent", "country": "US" }, "build": { "year": 2012, "make": "Honda", "model": "Accord", "trim": "SE", "version": "SE Auto", "body_type": "Sedan", "vehicle_type": "Car", "transmission": "Automatic", "drivetrain": "FWD", "fuel_type": "Unleaded", "engine": "2.4L I4", "engine_size": 2.4, "engine_block": "I", "doors": 4, "cylinders": 4, "highway_mpg": 34, "city_mpg": 23 } }, { "id": "1GCHK33F7RJ323144-6e82e85b-72e0", "vin": "1GCHK33F7RJ323144", "heading": "1994 Chevrolet K3500 Silverado |", "price": 4500, "miles": 162500, "msrp": 4500, "data_source": "mc", "vdp_url": "https://pensacola.craigslist.org//cto/7860295935.html", "carfax_1_owner": false, "carfax_clean_title": false, "exterior_color": "brown", "base_ext_color": "Brown", "dom": 1, "dom_180": 1, "dom_active": 1, "dos_active": 1, "seller_type": "fsbo", "inventory_type": "used", "last_seen_at": 1750810717, "last_seen_at_date": "2025-06-25T00:18:37.000Z", "scraped_at": 1750810717, "scraped_at_date": "2025-06-25T00:18:37.000Z", "first_seen_at": 1750810717, "first_seen_at_date": "2025-06-25T00:18:37.000Z", "first_seen_at_source": 1750810717, "first_seen_at_source_date": "2025-06-25T00:18:37.000Z", "first_seen_at_mc": 1750810717, "first_seen_at_mc_date": "2025-06-25T00:18:37.000Z", "source": "craigslist.org", "in_transit": false, "media": { "photo_links": [ "https://images.craigslist.org/00D0D_jrNdyWupSLA_0CI0t2_1200x900.jpg", "https://images.craigslist.org/00H0H_dlEh8Bh3RZy_0CI0t2_1200x900.jpg" ] }, "dealer": { "id": 1087211, "website": "craigslist.org", "name": "Private Seller", "dealer_type": "independent", "city": "Robertsdale", "state": "AL", "country": "US", "latitude": "30.572432", "longitude": "-87.662145", "zip": "36567" }, "mc_dealership": { "mc_website_id": 1087211, "mc_rooftop_id": 227100, "mc_category": "FSBO", "website": "craigslist.org", "name": "Private Seller", "dealer_type": "independent", "city": "Robertsdale", "state": "AL", "country": "US", "latitude": "30.572432", "longitude": "-87.662145", "zip": "36567" }, "build": { "year": 1994, "make": "Chevrolet", "model": "GMT400", "vehicle_type": "Truck" } } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/incentive/{make}/{zip}": { "get": { "operationId": "searchCarIncentiveMakeZip", "summary": "OEM Incentive by Make and ZIP", "tags": [ "Cars / Incentives" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/incentives/incentive-by-make-zip" }, "parameters": [ { "name": "make", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "zip", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/acquisition_fee_range" }, { "$ref": "#/components/parameters/apr_range" }, { "$ref": "#/components/parameters/base_sha" }, { "$ref": "#/components/parameters/cashback_amount_range" }, { "$ref": "#/components/parameters/cashback_target_group" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/dealer_contribution_range" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/disposition_fee_range" }, { "$ref": "#/components/parameters/down_payment_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/due_at_signing_range" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/gross_cap_cost_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_end_purchase_price_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/mileage_limit_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/monthly_range" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/net_cap_cost_range" }, { "$ref": "#/components/parameters/offer_type" }, { "$ref": "#/components/parameters/over_mileage_fee_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/scraped_at_date_range" }, { "$ref": "#/components/parameters/search_disclaimers_text" }, { "$ref": "#/components/parameters/search_offers_text" }, { "$ref": "#/components/parameters/search_titles_text" }, { "$ref": "#/components/parameters/security_deposit_range" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/status_date_range" }, { "$ref": "#/components/parameters/term_range" }, { "$ref": "#/components/parameters/term_unit" }, { "$ref": "#/components/parameters/total_monthly_payments_range" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/valid_from_range" }, { "$ref": "#/components/parameters/valid_through_range" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/photo_links" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 180, "listings": [ { "id": "ad2268ade59cbf7a061f97e3a55bfdf8384171c4b2f08881d670e634f9d1b17f", "base_sha": "094588e4a95ee3675ced71242ac6216e8f5ca8d3852952e1c07e46e39a5e0b15", "offer": { "vehicles": [ { "make": "Ford", "year": 2025, "model": "Ranger", "trim": "XLT" } ], "offer_type": "lease", "amounts": [ { "monthly": 369, "term": 36, "term_unit": "months" } ], "cashback_amount": 1000, "due_at_signing": 4509, "security_deposit": 0, "disposition_fee": 395, "over_mileage_fee": 0.2, "mileage_limit": 31500, "valid_from": "07/14/2025", "valid_through": "09/02/2025", "titles": [ "2025 Ford Ranger XLT" ], "offers": [ "$369 /mo. for 36 mos. Ford Credit Red Carpet Lease $4509 Cash Due at Signing Security Deposit Waived Taxes, Title, License Fees Extra" ], "disclaimers": [ "With Equipment Group 301A. Not all buyers will qualify for Ford Credit Red Carpet Lease. Payments may vary; dealer determines price. Residency restrictions apply. Cash due at signing is after $1,000 Bonus Customer Cash (PGM #11510). Lessee responsible for excess wear and mileage over 31,500 miles at $0.20 per mile. Lessee has option to purchase vehicle at lease end at price negotiated with dealer at signing. $395 lease disposition fee waived at lease end if vehicle is purchased or customer lease..." ] }, "msa_code": "4480", "zip": "90210", "dealer_id": "10000345", "source": "ford.com", "status_date": "2025-07-17T09:38:59.000Z", "scraped_at_date": "2025-07-16T09:37:48.000Z", "city": "Beverly Hills", "state": "CA", "country": "US" }, { "id": "9cbea07b6219b70ab477195a0df2a9321d6fba0fdd83458385344f7859a69fb4", "base_sha": "0db87ca61c3205b467d47a700cd0e757df8079bb62b590f54f7c3ae2b7cd67da", "offer": { "vehicles": [ { "make": "Ford", "year": 2025, "model": "Bronco 4-Door", "trim": "Big Bend" } ], "offer_type": "lease", "amounts": [ { "monthly": 499, "term": 36, "term_unit": "months" } ], "cashback_amount": 1000, "due_at_signing": 499, "security_deposit": 0, "over_mileage_fee": 0.2, "mileage_limit": 31500, "valid_from": "07/08/2025", "valid_through": "09/02/2025", "titles": [ "2025 Ford Bronco Big Bend 4-Door" ], "offers": [ "$499 /mo. for 36 mos. Ford Credit Red Carpet Lease $499 Cash Due at Signing Security Deposit Waived, Taxes, Title, License Fees ExtraPlus Get a Complimentary 2-Year Maintenance Plan" ], "disclaimers": [ "Security deposit waived, taxes, title and license fees extra. With Equipment Group 222A. Not all buyers will qualify for Ford Credit Red Carpet Lease. Payments may vary; dealer determines price. Residency restrictions apply. Cash due at signing is after $1,000 Summer Sales Event RCL Cash (PGM #50634). Lessee responsible for excess wear and mileage over 31,500 miles at $0.20 per mile. Lessee has option to purchase vehicle at lease end at price negotiated with dealer at signing. $395 lease disposi..." ] }, "msa_code": "4480", "zip": "90210", "dealer_id": "10000345", "source": "ford.com", "status_date": "2025-07-16T11:50:25.000Z", "scraped_at_date": "2025-07-09T11:48:49.000Z", "city": "Beverly Hills", "state": "CA", "country": "US" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/incentive/oem": { "get": { "operationId": "searchCarIncentiveOem", "summary": "OEM Incentive Search: Pagination", "tags": [ "Cars / Incentives" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/incentives/incentive-search-api" }, "parameters": [ { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/offer_type" }, { "$ref": "#/components/parameters/monthly_range" }, { "$ref": "#/components/parameters/apr_range" }, { "$ref": "#/components/parameters/term_range" }, { "$ref": "#/components/parameters/term_unit" }, { "$ref": "#/components/parameters/cashback_amount_range" }, { "$ref": "#/components/parameters/cashback_target_group" }, { "$ref": "#/components/parameters/down_payment_range" }, { "$ref": "#/components/parameters/due_at_signing_range" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/security_deposit_range" }, { "$ref": "#/components/parameters/acquisition_fee_range" }, { "$ref": "#/components/parameters/disposition_fee_range" }, { "$ref": "#/components/parameters/dealer_contribution_range" }, { "$ref": "#/components/parameters/total_monthly_payments_range" }, { "$ref": "#/components/parameters/mileage_limit_range" }, { "$ref": "#/components/parameters/over_mileage_fee_range" }, { "$ref": "#/components/parameters/lease_end_purchase_price_range" }, { "$ref": "#/components/parameters/net_cap_cost_range" }, { "$ref": "#/components/parameters/gross_cap_cost_range" }, { "$ref": "#/components/parameters/valid_from_range" }, { "$ref": "#/components/parameters/valid_through_range" }, { "$ref": "#/components/parameters/status_date_range" }, { "$ref": "#/components/parameters/scraped_at_date_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/search_titles_text" }, { "$ref": "#/components/parameters/search_offers_text" }, { "$ref": "#/components/parameters/search_disclaimers_text" }, { "$ref": "#/components/parameters/base_sha" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/photo_links" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 816167, "listings": [ { "id": "5e4e9a34e3c0157a87ed6f2fc27301ab10863b90f9609a3cc173a6b740dcd3bd", "base_sha": "0ff4c8d19724385843044982726f4d95747d074dff81b734ccb7b030a95007b3", "offer": { "vehicles": [ { "make": "Acura", "year": 2025, "model": "RDX", "trim": "Base", "transmission": "10 Speed Automatic", "drivetrain": "AWD" } ], "offer_type": "lease", "amounts": [ { "monthly": 449, "term": 36, "term_unit": "months" } ], "due_at_signing": 4999, "msrp": 46050, "down_payment": 4550, "security_deposit": 0, "acquisition_fee": 595, "net_cap_cost": 38506, "total_monthly_payments": 16164, "lease_end_purchase_price": 26709, "over_mileage_fee": 0.00186, "mileage_limit": 10000, "valid_from": "07/01/2025", "valid_through": "09/02/2025", "titles": [ "2025 RDX SH-AWD 10 Speed Automatic Featured Special Loyalty/Conquest Lease", "Featured Special Lease" ], "offers": [ "$449.00 PER MO./36 MO. $4,999.00 due at lease signing.", "Includes down payment with no security deposit. Excludes taxes, titles, license and documentary service fees. For well-qualified lessees who currently own a 2015 or newer Acura, Audi, BMW, Buick, Cadillac, Chevrolet, Ford, Genesis, GMC, Honda, Hyundai, Infiniti, Kia, Lexus, Lincoln, Mazda, Mercedes-Benz, Nissan, Subaru, Tesla, Toyota, Volkswagen or Volvo vehicle." ], "disclaimers": [ "Excludes residents of IL. Subject to availability through September 2, 2025 on approved credit through Acura Financial Services. Closed-end lease for 2025 RDX SH-AWD 10 Speed Automatic vehicles (TC2H4SJNW). Lease offer only available to qualified current owners of a 2015 or newer Acura, Audi, BMW, Buick, Cadillac, Chevrolet, Ford, Genesis, GMC, Honda, Hyundai, Infiniti, Kia, Lexus, Lincoln, Mazda, Mercedes-Benz, Nissan, Subaru, Tesla, Toyota, Volkswagen or Volvo vehicle. Not all lessees will qua...", "Must take new retail delivery of vehicle from dealer stock by September 2, 2025. Monthly payment and total due at lease signing calculated with $500 towards the capitalized cost reduction. Lessee responsible for maintenance, excessive wear/tear and up to 20 /mile over 10,000 miles/year. Not all customers qualify for Loyalty/Conquest offer. See your participating Acura dealer for complete details." ], "oem_program_name": "Featured Special Lease", "offer_link": "https://www.acura.com/tools/current-luxury-car-suv-offers-leasing?vehiclemodelseries=RDX&zipcode=79605" }, "msa_code": "0040", "zip": "79605", "dealer_id": "10000334", "source": "acura.com", "status_date": "2025-07-17T19:26:37.000Z", "scraped_at_date": "2025-07-01T19:24:36.000Z", "city": "Abilene", "state": "TX", "country": "US" }, { "id": "e94b31771f4efce060ddde112a8e560a3ac466888ef964186642923fcff3635e", "base_sha": "1ab72c9a47c95d983c30ec8db2778e0209ed2b1a3d1283b8aedab2e5767f8503", "offer": { "vehicles": [ { "make": "Acura", "year": 2025, "model": "Integra", "transmission": "Continuously Variable Transmission" } ], "offer_type": "lease", "amounts": [ { "monthly": 359, "term": 48, "term_unit": "months" } ], "due_at_signing": 2999, "msrp": 34195, "down_payment": 2640, "security_deposit": 0, "acquisition_fee": 595, "net_cap_cost": 30534, "total_monthly_payments": 17232, "lease_end_purchase_price": 17097, "over_mileage_fee": 0.00166, "mileage_limit": 10000, "valid_from": "07/01/2025", "valid_through": "07/31/2025", "titles": [ "2025 Integra Continuously Variable Transmission Featured Special Loyalty/Conquest Lease", "Featured Special Lease" ], "offers": [ "$359.00 PER MO./48 MO. $2,999.00 due at lease signing.", "Includes down payment with no security deposit. Excludes taxes, titles, license and documentary service fees. For well-qualified lessees who currently own a 2015 or newer Acura, Audi, BMW, Cadillac, Chevrolet, Ford, Genesis, GMC, Honda, Hyundai, Infiniti, Kia, Lexus, Mazda, Mercedes-Benz, Nissan, Subaru, Toyota, Volkswagen or Volvo vehicle." ], "disclaimers": [ "Excludes residents of IL. Subject to availability through July 31, 2025 on approved credit through Acura Financial Services. Closed-end lease for 2025 Integra Continuously Variable Transmission vehicles (DE4H2SJW). Lease offer only available to qualified current owners of a 2015 or newer Acura, Audi, BMW, Cadillac, Chevrolet, Ford, Genesis, GMC, Honda, Hyundai, Infiniti, Kia, Lexus, Mazda, Mercedes-Benz, Nissan, Subaru, Toyota, Volkswagen or Volvo vehicle. Not all lessees will qualify. Higher le...", "Must take new retail delivery of vehicle from dealer stock by July 31, 2025. Monthly payment and total due at lease signing calculated with $1,250 towards the capitalized cost reduction. Lessee responsible for maintenance, excessive wear/tear and up to 20 /mile over 10,000 miles/year. Not all customers qualify for Loyalty/Conquest offer. See your participating Acura dealer for complete details." ], "oem_program_name": "Featured Special Lease", "offer_link": "https://www.acura.com/tools/current-luxury-car-suv-offers-leasing?vehiclemodelseries=Integra&zipcode=79605" }, "msa_code": "0040", "zip": "79605", "dealer_id": "10000334", "source": "acura.com", "status_date": "2025-07-17T19:26:35.000Z", "scraped_at_date": "2025-07-01T19:24:38.000Z", "city": "Abilene", "state": "TX", "country": "US" } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/recents": { "get": { "operationId": "searchCarRecents", "summary": "Past Inventory Search", "tags": [ "Cars / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/inventory/past-inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/active_inventory_date_range" }, { "$ref": "#/components/parameters/append_api_key" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/carfax_1_owner" }, { "$ref": "#/components/parameters/carfax_clean_title" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/country_v3" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dealership_group_name" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_sources" }, { "$ref": "#/components/parameters/expired" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/finance_down_payment" }, { "$ref": "#/components/parameters/finance_down_payment_per" }, { "$ref": "#/components/parameters/finance_emp" }, { "$ref": "#/components/parameters/finance_loan_apr" }, { "$ref": "#/components/parameters/finance_loan_term" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_finance" }, { "$ref": "#/components/parameters/include_lease" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/lease_down_payment" }, { "$ref": "#/components/parameters/lease_emp" }, { "$ref": "#/components/parameters/lease_term" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/nodedup" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/price_change_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sold" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/taxonomy_vins" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/vehicle_status" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/vins" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymmt" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 15, "listings": [], "stats": { "price": { "min": 29500, "max": 36998, "count": 14, "missing": 1, "sum": 468797, "mean": 33485.5, "stddev": 2202.8, "sum_of_squares": 15765834255, "median": 34052.5, "percentiles": { "5.0": 29696.95, "25.0": 31991.5, "50.0": 34052.5, "75.0": 34973, "90.0": 35681.5, "95.0": 36332.4, "99.0": 36864.88 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/uk/active": { "get": { "operationId": "searchCarUkActive", "summary": "Inventory Search", "tags": [ "UK Cars / Inventory" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/append_api_key_v2" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_location_city" }, { "$ref": "#/components/parameters/car_location_county" }, { "$ref": "#/components/parameters/car_location_latitude" }, { "$ref": "#/components/parameters/car_location_longitude" }, { "$ref": "#/components/parameters/car_location_seller_name" }, { "$ref": "#/components/parameters/car_location_street" }, { "$ref": "#/components/parameters/car_location_zip" }, { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/co2_emissions" }, { "$ref": "#/components/parameters/combined_mpg_range" }, { "$ref": "#/components/parameters/country_v6" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/ev_battery_capacity_range" }, { "$ref": "#/components/parameters/ev_battery_type" }, { "$ref": "#/components/parameters/ev_vehicle_range" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_sources_v2" }, { "$ref": "#/components/parameters/exclude_write_off_category" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/fca_status" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type_v2" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_preferred_dealer_flag" }, { "$ref": "#/components/parameters/insurance_group" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/is_vat_included" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match_v2" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/min_photo_links" }, { "$ref": "#/components/parameters/min_photo_links_cached" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/model_variant" }, { "$ref": "#/components/parameters/msrp_range_v2" }, { "$ref": "#/components/parameters/nodedup_v2" }, { "$ref": "#/components/parameters/num_owners" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/performance_co2_range" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/powertrain_type_v2" }, { "$ref": "#/components/parameters/preferred_dealers" }, { "$ref": "#/components/parameters/preferred_dealers_only" }, { "$ref": "#/components/parameters/price_change" }, { "$ref": "#/components/parameters/price_change_range_v2" }, { "$ref": "#/components/parameters/price_range_v2" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source_v2" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v6" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim_v2" }, { "$ref": "#/components/parameters/ulez_compliant" }, { "$ref": "#/components/parameters/uvc_id" }, { "$ref": "#/components/parameters/variant" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_registration_date_range" }, { "$ref": "#/components/parameters/vehicle_registration_mark" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/vrm_v2" }, { "$ref": "#/components/parameters/wheelbase_category" }, { "$ref": "#/components/parameters/write_off_category" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymmt_v3" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 274, "listings": [], "stats": { "dom": { "min": 1, "max": 1001, "count": 274, "missing": 0, "sum": 18043, "mean": 65.85, "stddev": 107.52, "sum_of_squares": 4355919, "median": 29, "percentiles": { "5.0": 4, "25.0": 13, "50.0": 29, "75.0": 78.5, "90.0": 149.1, "95.0": 234.1, "99.0": 424.98 } }, "dom_active": { "min": 1, "max": 890, "count": 274, "missing": 0, "sum": 13779, "mean": 50.29, "stddev": 83.38, "sum_of_squares": 2597607, "median": 23, "percentiles": { "5.0": 3.65, "25.0": 11, "50.0": 23, "75.0": 56.75, "90.0": 116.4, "95.0": 178.45, "99.0": 346.6 } }, "dos_active": { "min": 1, "max": 890, "count": 274, "missing": 0, "sum": 13397, "mean": 48.89, "stddev": 83.16, "sum_of_squares": 2549855, "median": 21, "percentiles": { "5.0": 3, "25.0": 11, "50.0": 21, "75.0": 54, "90.0": 116.4, "95.0": 178.45, "99.0": 344.17 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/uk/auto-complete": { "get": { "operationId": "searchCarUkAutoComplete", "summary": "Auto-Complete", "tags": [ "UK Cars / Inventory" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/inventory/auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/car_location_city" }, { "$ref": "#/components/parameters/car_location_county" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_sources_v2" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_min_count" }, { "$ref": "#/components/parameters/fuel_type_v2" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/in_transit" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_count_range" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/mm_v2" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/seller_type" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/term_counts" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/variant" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/ymm_v2" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "terms": [ { "item": "Focus", "count": 9257 }, { "item": "Focus C-Max", "count": 15 } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/car/uk/recents": { "get": { "operationId": "searchCarUkRecents", "summary": "Past Inventory Search", "tags": [ "UK Cars / Inventory" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/cars/inventory/past-inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/active_inventory_date_range" }, { "$ref": "#/components/parameters/append_api_key_v2" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/car_type" }, { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/city_mpg_range" }, { "$ref": "#/components/parameters/combined_mpg_range" }, { "$ref": "#/components/parameters/country_v6" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/dealer_type" }, { "$ref": "#/components/parameters/dealership_group_name" }, { "$ref": "#/components/parameters/dedup" }, { "$ref": "#/components/parameters/dom_180_range" }, { "$ref": "#/components/parameters/dom_active_range" }, { "$ref": "#/components/parameters/dom_range" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/dos_active_range" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_aspiration" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/engine_size_range" }, { "$ref": "#/components/parameters/exclude_certified" }, { "$ref": "#/components/parameters/exclude_dealer_ids" }, { "$ref": "#/components/parameters/exclude_make" }, { "$ref": "#/components/parameters/exclude_mc_website_ids" }, { "$ref": "#/components/parameters/exclude_sources_v2" }, { "$ref": "#/components/parameters/exclude_write_off_category" }, { "$ref": "#/components/parameters/expired_v2" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/fca_status" }, { "$ref": "#/components/parameters/first_seen_at_mc_days" }, { "$ref": "#/components/parameters/first_seen_at_mc_range" }, { "$ref": "#/components/parameters/first_seen_at_source_days" }, { "$ref": "#/components/parameters/first_seen_at_source_range" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type_v2" }, { "$ref": "#/components/parameters/highway_mpg_range" }, { "$ref": "#/components/parameters/include_non_vin_listings" }, { "$ref": "#/components/parameters/include_relevant_links" }, { "$ref": "#/components/parameters/insurance_group" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/is_vat_included" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/match_v2" }, { "$ref": "#/components/parameters/mc_category" }, { "$ref": "#/components/parameters/mc_dealer_id" }, { "$ref": "#/components/parameters/mc_dealership_group_id" }, { "$ref": "#/components/parameters/mc_dealership_group_name" }, { "$ref": "#/components/parameters/mc_location_id" }, { "$ref": "#/components/parameters/mc_rooftop_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_id" }, { "$ref": "#/components/parameters/mc_sub_dealership_group_name" }, { "$ref": "#/components/parameters/mc_website_id" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/model_variant" }, { "$ref": "#/components/parameters/nodedup_v2" }, { "$ref": "#/components/parameters/num_owners" }, { "$ref": "#/components/parameters/owned" }, { "$ref": "#/components/parameters/photo_links" }, { "$ref": "#/components/parameters/photo_links_cached" }, { "$ref": "#/components/parameters/plot" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/price_change_range_v2" }, { "$ref": "#/components/parameters/price_range_v2" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/sold" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source_v2" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v6" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim_v2" }, { "$ref": "#/components/parameters/ulez_compliant" }, { "$ref": "#/components/parameters/variant" }, { "$ref": "#/components/parameters/vdp_url" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/vrm_v2" }, { "$ref": "#/components/parameters/wheelbase_category" }, { "$ref": "#/components/parameters/write_off_category" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/ymmt_v3" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 25, "listings": [], "stats": { "price": { "min": 9327, "max": 13498, "count": 25, "missing": 0, "sum": 302998, "mean": 12119.92, "stddev": 1142.6, "sum_of_squares": 3704949774, "median": 12599, "percentiles": { "5.0": 9773.4, "25.0": 11699, "50.0": 12599, "75.0": 12799, "90.0": 13259, "95.0": 13458.2, "99.0": 13498 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/heavy-equipment/active": { "get": { "operationId": "searchHeavyEquipmentActive", "summary": "Inventory Search", "tags": [ "Heavy Equipments / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/heavy-equipments/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/category" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/hours_used_range" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_type" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v2" }, { "$ref": "#/components/parameters/search_text" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/sub_category" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 1488, "listings": [ { "id": "f6e332394d6f6a3e3e5cedee55f0d215-11fd672a-d906", "heading": "2023 Kubota TR48", "vdp_url": "https://local.bahrns.com/new-models/2023-kubota-tr48-29052569b", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1754530075, "last_seen_at_date": "2025-08-07T01:27:55.000Z", "scraped_at": 1728596037, "scraped_at_date": "2024-10-10T21:33:57.000Z", "first_seen_at": 1728596037, "first_seen_at_date": "2024-10-10T21:33:57.000Z", "source": "local.bahrns.com", "media": { "photo_links": [ "https://cdnmedia.endeavorsuite.com/images/ThumbGenerator/Thumb.aspx?img=//cdnmedia.endeavorsuite.com/images/catalogs/23185/products/detail/366179e8-3e4a-4734-91e0-580263f37743.jpg&mw=1000&mh=563&f=1", "https://cdnmedia.endeavorsuite.com/images/ThumbGenerator/Thumb.aspx?img=//cdnmedia.endeavorsuite.com/images/catalogs/23185/products/detail/1e76032f-3ccd-49bd-a2de-baee1803bb05.jpg&mw=1000&mh=563&f=1" ] }, "dealer": { "id": 10007155, "website": "local.bahrns.com", "name": "Mh Equipment", "street": "817 E Voorhees St", "city": "Danville", "state": "IL", "latitude": "40.146339", "longitude": "-87.613939", "zip": "61832" }, "build": { "year": 2023, "make": "KUBOTA", "model": "TR48", "engine": "Kawasaki FR651", "length": "31 1/2 in. (80 cm)" } }, { "id": "c2f15fec0269a00d8bf8679c1d195336-62097ada-b4d6", "heading": "2023 Kubota SRB1572", "vdp_url": "https://local.bahrns.com/new-models/2023-kubota-srb1572-29052520b", "seller_type": "dealer", "inventory_type": "used", "last_seen_at": 1754529974, "last_seen_at_date": "2025-08-07T01:26:14.000Z", "scraped_at": 1728596038, "scraped_at_date": "2024-10-10T21:33:58.000Z", "first_seen_at": 1728596038, "first_seen_at_date": "2024-10-10T21:33:58.000Z", "source": "local.bahrns.com", "media": { "photo_links": [ "https://cdnmedia.endeavorsuite.com/images/ThumbGenerator/Thumb.aspx?img=//cdnmedia.endeavorsuite.com/images/catalogs/23185/products/detail/fd37edc6-b20e-4e9c-bc28-2e66acf21e2c.jpg&mw=1000&mh=563&f=1", "https://cdnmedia.endeavorsuite.com/images/ThumbGenerator/Thumb.aspx?img=//cdnmedia.endeavorsuite.com/images/catalogs/23185/products/detail/8ab8ba05-a562-402d-b8da-47cfbe2202e3.jpg&mw=1000&mh=563&f=1" ] }, "dealer": { "id": 10007155, "website": "local.bahrns.com", "name": "Mh Equipment", "street": "817 E Voorhees St", "city": "Danville", "state": "IL", "latitude": "40.146339", "longitude": "-87.613939", "zip": "61832" }, "build": { "year": 2023, "make": "KUBOTA", "model": "B15", "category": "Agriculture", "engine": "KT725", "length": "Of Teeth: 39 in. (.99 m)" } } ], "facets": { "category": [ { "item": "Agriculture", "count": 369 }, { "item": "Construction", "count": 67 } ] }, "stats": { "price": { "min": 4600, "max": 80761, "count": 424, "missing": 1064, "sum": 14146568, "mean": 33364.55, "stddev": 17400.27, "sum_of_squares": 600368064440, "median": 28796, "percentiles": { "5.0": 13560, "25.0": 19279, "50.0": 28796, "75.0": 43450, "90.0": 61163.9, "95.0": 69459, "99.0": 76839 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/heavy-equipment/auto-complete": { "get": { "operationId": "searchHeavyEquipmentAutoComplete", "summary": "Auto-Complete", "tags": [ "Heavy Equipments / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/heavy-equipments/inventory/auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/color" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/facet_min_count" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/inventory_type" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/seller_type" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/term_counts" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/motorcycle/active": { "get": { "operationId": "searchMotorcycleActive", "summary": "Inventory Search", "tags": [ "Motorcycles / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/motorcycles/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/color" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/inventory_type" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/motorcycle_taxonomy_vin" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows_v2" }, { "$ref": "#/components/parameters/search_text" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 5051, "listings": [ { "id": "682e30fb10f499110fb9f944ffe9c190-f4dbdb15-93e5", "vin": "1HD1BVJ11PB058148", "heading": "2023 Harley-Davidson FXST - Softail Standard", "vdp_url": "http://www.mmsoxford.com/Pre-owned-Inventory-2023-Harley-Davidson-Motorcycle-Scooter-FXST-Softail-Standard-Cruiser-Oxford-16089036?ref=list", "seller_type": "dealer", "inventory_type": "used", "stock_no": "UM058148", "last_seen_at": 1754531883, "last_seen_at_date": "2025-08-07T01:58:03.000Z", "scraped_at": 1751591854, "scraped_at_date": "2025-07-04T01:17:34.000Z", "first_seen_at": 1751591854, "first_seen_at_date": "2025-07-04T01:17:34.000Z", "source": "mtn-motorsportstn.com", "media": { "photo_links": [ "https://cdn.dealerspike.com/imglib/v1/800x600/imglib/Assets/Inventory/22/B0/22B08C0B-7742-4CDD-8DD9-D5F5FEBE8B47.jpg", "https://cdn.dealerspike.com/imglib/v1/800x600/imglib/Assets/Inventory/D9/4E/D94E782F-113D-4A8E-8BCD-B31EE1DFBBCB.jpg" ] }, "dealer": { "id": 3151, "website": "mtn-motorsportstn.com", "name": "Mountain Motorsports - Sevierville", "dealer_type": "franchise", "street": "3422 Adventure Lane", "city": "Kodak", "state": "TN", "latitude": "35.981929", "longitude": "-83.613593", "zip": "37764", "msa_code": "3840" }, "build": { "year": 2023, "make": "Harley-Davidson", "model": "Softail", "trim": "Standard", "vehicle_type": "MOTORCYCLE / SCOOTER", "drivetrain": "Chain, 34/46 ratio", "engine": "Milwaukee-Eight 107" } }, { "id": "a6cfb47e14508103d928bcfc81b515cd-62a457aa-64b0", "vin": "1HD1YWZ1XPB028719", "heading": "2023 Harley-Davidson Low Rider S FXLRS $17,953 Now $13,088", "price": 13088, "miles": 2958, "msrp": 17953, "vdp_url": "https://rockstarharley.com/inventory/752520/2023-harley-davidson-low-rider-s-fxlrs", "color": "White Sand Pearl", "seller_type": "dealer", "inventory_type": "used", "stock_no": "U028719", "last_seen_at": 1754531707, "last_seen_at_date": "2025-08-07T01:55:07.000Z", "scraped_at": 1750727467, "scraped_at_date": "2025-06-24T01:11:07.000Z", "first_seen_at": 1750727467, "first_seen_at_date": "2025-06-24T01:11:07.000Z", "source": "rockstarharley.com", "media": { "photo_links": [ "http://cdn.room58.com/2024/03/15/3979d4d577b48c6b26b2fc9ff4f047d0_527a82b68590d37e.jpg", "http://cdn.room58.com/2024/03/15/9faaf657d0d252e7fc013ca1b1797f1a_77208db625997d8e.jpg" ] }, "dealer": { "id": 10001457, "website": "rockstarharley.com", "name": "Rockstar Harley-davidson", "dealer_type": "franchise", "street": "9501 Thunder Rd.", "city": "Fort Myers", "state": "FL", "latitude": "26.541373", "longitude": "-81.792895", "zip": "33913", "msa_code": "2700" }, "build": { "year": 2023, "make": "Harley-Davidson", "model": "Low Rider", "engine": "Milwaukee-Eight 117" } } ], "facets": { "vehicle_type": [ { "item": "MOTORCYCLE / SCOOTER", "count": 2315 }, { "item": "MOTORCYCLE", "count": 628 } ] }, "stats": { "price": { "min": 8977, "max": 43000, "count": 276, "missing": 4775, "sum": 5723800, "mean": 20738.41, "stddev": 8042.51, "sum_of_squares": 136554716972, "median": 19947.5, "percentiles": { "5.0": 10644, "25.0": 13995, "50.0": 19947.5, "75.0": 25991.25, "90.0": 31999, "95.0": 36135.25, "99.0": 41552 } } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/motorcycle/auto-complete": { "get": { "operationId": "searchMotorcycleAutoComplete", "summary": "Auto-Complete", "tags": [ "Motorcycles / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/motorcycles/inventory/auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/color" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/seller_type" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/term_counts" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/type" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "terms": [ { "item": "Fat Bob", "count": 51 }, { "item": "Fat Boy", "count": 144 } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/rv/active": { "get": { "operationId": "searchRvActive", "summary": "Inventory Search", "tags": [ "Recreational Vehicles / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/recreational-vehicles/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/class" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_id" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fresh_water_capacity" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/gvwr" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/inventory_type" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/length" }, { "$ref": "#/components/parameters/length_range" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/model_o" }, { "$ref": "#/components/parameters/msa_code" }, { "$ref": "#/components/parameters/msrp_range" }, { "$ref": "#/components/parameters/number_of_awnings" }, { "$ref": "#/components/parameters/price_range" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/search_text" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/slideouts" }, { "$ref": "#/components/parameters/sleeps" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/stock_no" }, { "$ref": "#/components/parameters/tokenized_search_text" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/vin" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "terms": [ { "item": "Forester", "count": 30 }, { "item": "Forester Classic", "count": 12 } ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/rv/auto-complete": { "get": { "operationId": "searchRvAutoComplete", "summary": "Auto-Complete", "tags": [ "Recreational Vehicles / Inventory" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/recreational-vehicles/inventory/auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/city" }, { "$ref": "#/components/parameters/color" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/seller_type" }, { "$ref": "#/components/parameters/sort_by_v2" }, { "$ref": "#/components/parameters/state_v2" }, { "$ref": "#/components/parameters/term_counts" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/zip" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/search/rv/uk/active": { "get": { "operationId": "searchRvUkActive", "summary": "Inventory Search", "tags": [ "UK Recreational Vehicles / Inventory" ], "x-region": "uk", "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/uk/docs/api/recreational-vehicles/inventory/inventory-search" }, "parameters": [ { "$ref": "#/components/parameters/availability_status" }, { "$ref": "#/components/parameters/base_ext_color" }, { "$ref": "#/components/parameters/base_exterior_color" }, { "$ref": "#/components/parameters/base_int_color" }, { "$ref": "#/components/parameters/base_interior_color" }, { "$ref": "#/components/parameters/berths" }, { "$ref": "#/components/parameters/category_v2" }, { "$ref": "#/components/parameters/chassis" }, { "$ref": "#/components/parameters/city_v2" }, { "$ref": "#/components/parameters/county" }, { "$ref": "#/components/parameters/cylinders" }, { "$ref": "#/components/parameters/dealer_name" }, { "$ref": "#/components/parameters/doors" }, { "$ref": "#/components/parameters/drive_type" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/exterior_color" }, { "$ref": "#/components/parameters/exterior_length_range" }, { "$ref": "#/components/parameters/facet_sort" }, { "$ref": "#/components/parameters/facets" }, { "$ref": "#/components/parameters/first_seen_days" }, { "$ref": "#/components/parameters/first_seen_range" }, { "$ref": "#/components/parameters/fuel_type_v2" }, { "$ref": "#/components/parameters/interior_color" }, { "$ref": "#/components/parameters/interior_length_range" }, { "$ref": "#/components/parameters/inventory_type" }, { "$ref": "#/components/parameters/last_seen_days" }, { "$ref": "#/components/parameters/last_seen_range" }, { "$ref": "#/components/parameters/latitude" }, { "$ref": "#/components/parameters/longitude" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/miles_range" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/msrp_range_v2" }, { "$ref": "#/components/parameters/mtplm" }, { "$ref": "#/components/parameters/postal_code" }, { "$ref": "#/components/parameters/price_range_v2" }, { "$ref": "#/components/parameters/radius" }, { "$ref": "#/components/parameters/range_facets" }, { "$ref": "#/components/parameters/rows" }, { "$ref": "#/components/parameters/seating_capacity" }, { "$ref": "#/components/parameters/search_text" }, { "$ref": "#/components/parameters/sort_by" }, { "$ref": "#/components/parameters/sort_order" }, { "$ref": "#/components/parameters/source_v2" }, { "$ref": "#/components/parameters/start" }, { "$ref": "#/components/parameters/state_v6" }, { "$ref": "#/components/parameters/stats" }, { "$ref": "#/components/parameters/steering" }, { "$ref": "#/components/parameters/sub_category" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/width_range" }, { "$ref": "#/components/parameters/year" }, { "$ref": "#/components/parameters/year_range" }, { "$ref": "#/components/parameters/zip" }, { "$ref": "#/components/parameters/has_price" }, { "$ref": "#/components/parameters/has_miles" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "num_found": 66, "listings": [], "range_facets": { "price": { "counts": [ { "lower_bound": 10500, "upper_bound": 20500, "count": 9 }, { "lower_bound": 20500, "upper_bound": 30500, "count": 39 } ], "interval": 10000, "start": 500, "end": 100000, "between": 66 }, "miles": { "counts": [ { "lower_bound": 5000, "upper_bound": 10000, "count": 1 } ], "interval": 5000, "start": 5000, "end": 50000, "before": 4, "between": 1 } } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/specs/car/auto-complete": { "get": { "operationId": "specsCarAutoComplete", "summary": "Taxonomy Auto-Complete", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/taxonomy-auto-complete" }, "parameters": [ { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/facet_min_count" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/ignore_case" }, { "$ref": "#/components/parameters/input" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "terms": [ "60th Anniversary", "Base" ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/specs/car/terms": { "get": { "operationId": "specsCarTerms", "summary": "Taxonomy Facets", "tags": [ "Cars / Vehicle Specs" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/vehicle-specs/taxonomy-facets" }, "parameters": [ { "$ref": "#/components/parameters/body_subtype" }, { "$ref": "#/components/parameters/body_type" }, { "$ref": "#/components/parameters/drivetrain" }, { "$ref": "#/components/parameters/engine" }, { "$ref": "#/components/parameters/engine_block" }, { "$ref": "#/components/parameters/engine_size" }, { "$ref": "#/components/parameters/field" }, { "$ref": "#/components/parameters/fuel_type" }, { "$ref": "#/components/parameters/make" }, { "$ref": "#/components/parameters/model" }, { "$ref": "#/components/parameters/transmission" }, { "$ref": "#/components/parameters/trim" }, { "$ref": "#/components/parameters/vehicle_type" }, { "$ref": "#/components/parameters/year" } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "fuel_type": [ "E85 / Unleaded", "Electric" ] } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/vindata/access-report/aamva/{vin}": { "get": { "operationId": "vindataAccessReportAamvaVin", "summary": "VINData AAMVA Reports: API Endpoints & Features", "tags": [ "Cars / Third Party" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/third-party/vindata" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": { "example": { "navigation": false, "response": { "productName": "NMVTIS", "titleInformation": [ { "date": "2016-04-21T00:00:00Z", "state": "California", "type": "Current", "reportedOdometer": "100,720", "measure": "M", "event": "Title issued", "source": "NMVTIS", "vin": "1FAHP3F28CL148530", "vinChanged": false }, { "date": "2016-02-17T00:00:00Z", "state": "California", "type": "Historical", "reportedOdometer": "56,705", "measure": "M", "event": "Title issued", "source": "NMVTIS", "vin": "1FAHP3F28CL148530", "vinChanged": false } ], "titleBrandReported": [], "junkSalvageTotalLoss": [], "odometerInformation": [], "summary": { "make": "FORD", "model": "Focus", "year": 2012, "type": "car", "empty": false }, "trimLevels": { "Default": {} }, "reportSummary": { "message": "Good news – no warning or cautionary events have been reported to VINData History. We recommend an inspection by a qualified mechanic.", "color": "green" } } } } } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } }, "/vindata/generate-report/aamva/{vin}": { "get": { "operationId": "vindataGenerateReportAamvaVin", "summary": "VINData AAMVA Reports: API Endpoints & Features", "tags": [ "Cars / Third Party" ], "externalDocs": { "description": "Full documentation (append .md for raw markdown)", "url": "https://docs.marketcheck.com/docs/api/cars/third-party/vindata" }, "parameters": [ { "name": "vin", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response. See the linked documentation page for the full field reference.", "content": { "application/json": {} } }, "401": { "$ref": "#/components/responses/Error401" }, "404": { "$ref": "#/components/responses/Error404" }, "422": { "$ref": "#/components/responses/Error422" }, "429": { "$ref": "#/components/responses/Error429" } } } } }, "components": { "securitySchemes": { "api_key": { "type": "apiKey", "in": "query", "name": "api_key", "description": "Your MarketCheck API key, sent as a query parameter on every request. Get one at https://developers.marketcheck.com/sign-up." } }, "parameters": { "country": { "name": "country", "in": "query", "description": "Specifies the country market used for ranking. Supported values: `us` or `ca`. Defaults to `us`.", "schema": { "type": "string", "default": "us" } }, "include_generic": { "name": "include_generic", "in": "query", "description": "If `true`, includes generic VIN decode information in NeoVIN responses.", "schema": { "type": "boolean" } }, "include_available_options": { "name": "include_available_options", "in": "query", "description": "If `true`, includes available options details in NeoVIN responses.", "schema": { "type": "boolean" } }, "country_v2": { "name": "country", "in": "query", "description": "Two-letter country code (as per ISO 3166-1 alpha-2). Default - `us`.", "schema": { "type": "string", "default": "us" } }, "state": { "name": "state", "in": "query", "description": "Two-letter state/province code required for US and Canada plates. Must be exactly two characters (e.g., `CA`, `TX`, `ON`).", "schema": { "type": "string" } }, "city": { "name": "city", "in": "query", "description": "Filters listings by city name (e.g. `Los Angeles`, `San Francisco`, `Houston`).", "schema": { "type": "string" } }, "created_at_days": { "name": "created_at_days", "in": "query", "description": "Filters dealerships by age in days since creation. Specify as `min-max` days. Alternative of `created_at_range`.", "schema": { "type": "string" } }, "created_at_range": { "name": "created_at_range", "in": "query", "description": "Filters dealerships by creation date. Specify as `YYYYMMDD-YYYYMMDD`. Alternative of `created_at_days`.", "schema": { "type": "string" } }, "dealer_type": { "name": "dealer_type", "in": "query", "description": "Filters dealers by type. Allowed values — `franchise`, `independent`.", "schema": { "type": "string" } }, "facets": { "name": "facets", "in": "query", "description": "Field name to return bucket facets for. Accepts multiple fields as a comma-separated list.", "schema": { "type": "string" } }, "inventory_url": { "name": "inventory_url", "in": "query", "description": "Filters dealerships with their domain (e.g., `carmax.com`).", "schema": { "type": "string" } }, "latitude": { "name": "latitude", "in": "query", "description": "Latitude component of the search location (decimal degrees). Used for geospatial queries along with `longitude` and `radius` parameters.", "schema": { "type": "string" } }, "listing_count_range": { "name": "listing_count_range", "in": "query", "description": "Filters dealerships by the count of active listings. Specify as `min-max`.", "schema": { "type": "string" } }, "longitude": { "name": "longitude", "in": "query", "description": "Longitude component of the search location (decimal degrees). Used for geospatial queries along with `latitude` and `radius` parameters.", "schema": { "type": "string" } }, "country_v3": { "name": "country", "in": "query", "description": "Filters listings by country code. Allowed values - `us`, `ca`, `all`. Default — `us`.", "schema": { "type": "string", "default": "us" } }, "msa_code": { "name": "msa_code", "in": "query", "description": "Filters listings by Metropolitan Statistical Area (MSA) code.", "schema": { "type": "string" } }, "radius": { "name": "radius", "in": "query", "description": "Search radius around the specified location in miles. Used with `zip` or `latitude` and `longitude` for geospatial queries.", "schema": { "type": "integer" } }, "range_facets": { "name": "range_facets", "in": "query", "description": "Comma-separated list of numeric field names for which to return range facets in the response.", "schema": { "type": "string" } }, "rows": { "name": "rows", "in": "query", "description": "Number of results to return per request. Default — 10. Maximum — 50.", "schema": { "type": "integer", "default": 10 } }, "sort_by": { "name": "sort_by", "in": "query", "description": "Field to sort results by. If omitted, defaults to distance when a location filter is used.", "schema": { "type": "string" } }, "sort_order": { "name": "sort_order", "in": "query", "description": "Specifies result sort order. Allowed values — `asc` or `desc`. Default — `asc`.", "schema": { "type": "string", "default": "asc" } }, "start": { "name": "start", "in": "query", "description": "Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/`rows`.", "schema": { "type": "integer", "default": 0 } }, "state_v2": { "name": "state", "in": "query", "description": "Filters listings by US or Canadian state/province code (e.g., `CA`, `NY`, `ON`). Accepts multiple codes separated by commas.", "schema": { "type": "string" } }, "zip": { "name": "zip", "in": "query", "description": "Filters listings within the specified 5-digit ZIP code.", "schema": { "type": "string" } }, "city_v2": { "name": "city", "in": "query", "description": "Filters listings by city name (e.g. `London`, `Derby`, `Birmingham`).", "schema": { "type": "string" } }, "county": { "name": "county", "in": "query", "description": "Filters listings by county name (e.g. `Greater London`, `Lancashire`). Use instead of `state`. Accepts multiple counties as comma-separated values.", "schema": { "type": "string" } }, "uk_dealer_country": { "name": "uk_dealer_country", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "fca_status": { "name": "fca_status", "in": "query", "description": "FCA authorization status for dealers. (e.g., `Authorised`, `Appointed Representative`, `Registered`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "postal_code": { "name": "postal_code", "in": "query", "description": "Filters listings within the specified postal code (e.g., `M5H 2N2`).", "schema": { "type": "string" } }, "rows_v2": { "name": "rows", "in": "query", "description": "Number of results to return per request. Default — 10. Maximum — 10.", "schema": { "type": "integer", "default": 10 } }, "mc_category": { "name": "mc_category", "in": "query", "description": "Filters listings by MarketCheck category code. Case-insensitive.", "schema": { "type": "string" } }, "mc_dealer_id": { "name": "mc_dealer_id", "in": "query", "description": "Filters listings by MarketCheck dealer ID.", "schema": { "type": "string" } }, "mc_dealership_group_id": { "name": "mc_dealership_group_id", "in": "query", "description": "Filters listings by MarketCheck dealership group ID.", "schema": { "type": "string" } }, "mc_dealership_group_name": { "name": "mc_dealership_group_name", "in": "query", "description": "Filters listings by dealership group name.", "schema": { "type": "string" } }, "mc_location_id": { "name": "mc_location_id", "in": "query", "description": "Filters listings by MarketCheck location ID.", "schema": { "type": "string" } }, "mc_rooftop_id": { "name": "mc_rooftop_id", "in": "query", "description": "Filters listings by MarketCheck rooftop ID.", "schema": { "type": "string" } }, "mc_sub_dealership_group_id": { "name": "mc_sub_dealership_group_id", "in": "query", "description": "Filters listings by MarketCheck sub-dealership group ID.", "schema": { "type": "string" } }, "mc_sub_dealership_group_name": { "name": "mc_sub_dealership_group_name", "in": "query", "description": "Filters listings by sub-dealership group name.", "schema": { "type": "string" } }, "mc_website_id": { "name": "mc_website_id", "in": "query", "description": "Filters listings by MarketCheck website ID.", "schema": { "type": "string" } }, "append_api_key": { "name": "append_api_key", "in": "query", "description": "If `true`, the response URLs (such as cached images & relevant links) include the `api_key` query parameter along with value; if `false`, they do not. Default — `true`.", "schema": { "type": "boolean", "default": true } }, "base_ext_color": { "name": "base_ext_color", "in": "query", "description": "The base exterior color to filter results by (e.g. White, Black, Blue, Silver, Red). Accepts multiple colors as a comma-separated list.", "schema": { "type": "string" } }, "base_exterior_color": { "name": "base_exterior_color", "in": "query", "description": "Alias for `base_ext_color`. Filters by base exterior color (comma-separated list).", "schema": { "type": "string" } }, "base_int_color": { "name": "base_int_color", "in": "query", "description": "The base interior color to filter results by (e.g. Black, Brown, Beige, Red). Accepts multiple colors as a comma-separated list.", "schema": { "type": "string" } }, "base_interior_color": { "name": "base_interior_color", "in": "query", "description": "Alias for `base_int_color`. Filters by base interior color (comma-separated list).", "schema": { "type": "string" } }, "body_subtype": { "name": "body_subtype", "in": "query", "description": "Filters listings by body subtype (e.g., Crew, Extended, Regular, Extended Crew). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "body_type": { "name": "body_type", "in": "query", "description": "Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "car_type": { "name": "car_type", "in": "query", "description": "Filters listings by inventory type. Allowed values - `new`, `used`, `certified`.", "schema": { "type": "string" } }, "city_mpg_range": { "name": "city_mpg_range", "in": "query", "description": "Filters listings by city fuel-economy mileage. Specify as `min-max` MPG (e.g., `20-35`).", "schema": { "type": "string" } }, "cylinders": { "name": "cylinders", "in": "query", "description": "Filters listings by engine cylinder count (e.g., `4`, `6`, `8`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "dealer_id": { "name": "dealer_id", "in": "query", "description": "Filters listings by MarketCheck dealer ID.", "schema": { "type": "string" } }, "dealer_name": { "name": "dealer_name", "in": "query", "description": "Filters listings by dealer name (case-insensitive complete match, substring not supported).", "schema": { "type": "string" } }, "dealership_group_name": { "name": "dealership_group_name", "in": "query", "description": "Filters listings by the name of the dealership group. Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "dom_180_range": { "name": "dom_180_range", "in": "query", "description": "Filters listings by Days on Market observed over the last 180 days. Specify as `min-max` days (e.g., `10-50`).", "schema": { "type": "string" } }, "dom_active_range": { "name": "dom_active_range", "in": "query", "description": "Filters listings by active Days on Market (DOM). Specify as `min-max` days.", "schema": { "type": "string" } }, "dom_range": { "name": "dom_range", "in": "query", "description": "Filters listings by total Days on Market (DOM). Specify as `min-max` days.", "schema": { "type": "string" } }, "doors": { "name": "doors", "in": "query", "description": "Filters listings by number of doors (e.g., `2`, `4`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "dos_active_range": { "name": "dos_active_range", "in": "query", "description": "Filters listings by active Days on Site (DOS). Specify as `min-max` days.", "schema": { "type": "string" } }, "drivetrain": { "name": "drivetrain", "in": "query", "description": "Filters listings by drivetrain (`FWD`, `RWD`, `4WD`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "engine": { "name": "engine", "in": "query", "description": "Filters listings by engine designation (e.g., `2.0L I4`, `3.5L V6`, `2.5L H4`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "engine_aspiration": { "name": "engine_aspiration", "in": "query", "description": "Filters listings by engine aspiration (`Turbocharged`, `Naturally Aspirated`, etc.). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "engine_block": { "name": "engine_block", "in": "query", "description": "Filters listings by engine block layout (`V`, `I`, `H`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "engine_size": { "name": "engine_size", "in": "query", "description": "Filters listings by engine displacement size (e.g., `2.0`, `2.5`, `3.5`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "engine_size_range": { "name": "engine_size_range", "in": "query", "description": "Filters listings by engine displacement size. Specify as `min-max` liters (e.g., `1.5-3.0`).", "schema": { "type": "string" } }, "exterior_color": { "name": "exterior_color", "in": "query", "description": "Filters listings by exterior color (e.g. `White`, `Summit White`, `Gun Metallic`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "facet_sort": { "name": "facet_sort", "in": "query", "description": "Sorts facet buckets. Allowed values — `count` (descending count, default) or `index` (alphabetical).", "schema": { "type": "string", "default": "count" } }, "first_seen_at_mc_days": { "name": "first_seen_at_mc_days", "in": "query", "description": "Filters listings by the number of days since they were first seen by MarketCheck. Specify as `min-max` days. Alternative of `first_seen_at_mc_range`.", "schema": { "type": "string" } }, "first_seen_at_mc_range": { "name": "first_seen_at_mc_range", "in": "query", "description": "Filters listings by the date they were first seen by MarketCheck. Specify as `YYYYMMDD-YYYYMMDD` (e.g., `20220523-20220631`). Alternative of `first_seen_at_mc_days`.", "schema": { "type": "string" } }, "first_seen_at_source_days": { "name": "first_seen_at_source_days", "in": "query", "description": "Filters listings by the number of days since first seen on the source site. Specify as `min-max` days. Alternative of `first_seen_at_source_range`.", "schema": { "type": "string" } }, "first_seen_at_source_range": { "name": "first_seen_at_source_range", "in": "query", "description": "Filters listings by date first seen on the source site. Specify as `YYYYMMDD-YYYYMMDD`. Alternative of `first_seen_at_source_days`.", "schema": { "type": "string" } }, "first_seen_days": { "name": "first_seen_days", "in": "query", "description": "Filters listings by the number of days since they were first seen in MarketCheck inventory. Specify as `min-max` days. Alternative of `first_seen_range`.", "schema": { "type": "string" } }, "first_seen_range": { "name": "first_seen_range", "in": "query", "description": "Filters listings by the first seen date. Specify as `YYYYMMDD-YYYYMMDD` (e.g., `20220523-20220631`). Alternative of `first_seen_days`.", "schema": { "type": "string" } }, "fuel_type": { "name": "fuel_type", "in": "query", "description": "Filters listings by fuel type (e.g., `Unleaded`, `Diesel`, `Electric`, `Premium Unleaded`, `Electric / Unleaded`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "highway_mpg_range": { "name": "highway_mpg_range", "in": "query", "description": "Filters listings by highway fuel-economy mileage. Specify as `min-max` MPG (e.g., `25-40`).", "schema": { "type": "string" } }, "in_transit": { "name": "in_transit", "in": "query", "description": "If `true`, returns listings marked as in transit; if `false` or omitted, no in-transit filter is applied.", "schema": { "type": "boolean" } }, "include_non_vin_listings": { "name": "include_non_vin_listings", "in": "query", "description": "If `true`, includes listings without a VIN; if `false`, such listings are excluded. Default — false.", "schema": { "type": "boolean", "default": false } }, "include_relevant_links": { "name": "include_relevant_links", "in": "query", "description": "If `true`, includes relevant links to other MarketCheck API endpoints in the response. Default — false.", "schema": { "type": "boolean", "default": false } }, "interior_color": { "name": "interior_color", "in": "query", "description": "Filters listings by interior color. Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "last_seen_days": { "name": "last_seen_days", "in": "query", "description": "Filters listings by the number of days since last seen. Specify as `min-max` days. Alternative of `last_seen_at_range`.", "schema": { "type": "string" } }, "last_seen_range": { "name": "last_seen_range", "in": "query", "description": "Filters listings by last seen date. Specify as `YYYYMMDD-YYYYMMDD` (e.g., `20220523-20220631`). Alternative of `last_seen_at_days`.", "schema": { "type": "string" } }, "make": { "name": "make", "in": "query", "description": "Filters listings by vehicle make (e.g., `Toyota`, `Ford`, `Mercedes-Benz`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "miles_range": { "name": "miles_range", "in": "query", "description": "Filters listings by odometer reading. Specify as `min-max` miles (e.g., `1000-50000`).", "schema": { "type": "string" } }, "min_photo_links": { "name": "min_photo_links", "in": "query", "description": "Filters listings with at least the specified number of photo links (e.g. `3`, `8`).", "schema": { "type": "integer" } }, "min_photo_links_cached": { "name": "min_photo_links_cached", "in": "query", "description": "Filters listings with at least the specified number of cached photo links (e.g. `3`, `8`).", "schema": { "type": "integer" } }, "model": { "name": "model", "in": "query", "description": "Filters listings by specific vehicle model (e.g., `Camry`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "msrp_range": { "name": "msrp_range", "in": "query", "description": "Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as `min-max` USD (e.g., `20000-45000`).", "schema": { "type": "string" } }, "owned": { "name": "owned", "in": "query", "description": "When used with `dealer_id`, `mc_website_id`, or `source`, `true` returns listings actually owned by that dealer. Default — false.", "schema": { "type": "boolean" } }, "photo_links": { "name": "photo_links", "in": "query", "description": "If `true`, returns only listings that contain at least one photo link. Default — false.", "schema": { "type": "boolean" } }, "photo_links_cached": { "name": "photo_links_cached", "in": "query", "description": "If `true`, returns only listings that contain cached photo links. Default — false.", "schema": { "type": "boolean" } }, "powertrain_type": { "name": "powertrain_type", "in": "query", "description": "Filters listings by powertrain type (e.g., `Combustion`, `BEV`, `HEV`, `MHEV`, `PHEV`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "price_range": { "name": "price_range", "in": "query", "description": "Filters listings by advertised price in USD. Specify as `min-max` (e.g., `1000-50000`).", "schema": { "type": "string" } }, "rows_v3": { "name": "rows", "in": "query", "description": "Number of results to return per request. Default — 1500. Maximum — 1500.", "schema": { "type": "integer", "default": 1500 } }, "seating_capacity": { "name": "seating_capacity", "in": "query", "description": "Filters listings by seating capacity (e.g., `2`, `5`, `7`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "source": { "name": "source", "in": "query", "description": "Filters listings by website domain (e.g., `autotrader.com`, `cars.com`).", "schema": { "type": "string" } }, "stats": { "name": "stats", "in": "query", "description": "Comma-separated list of numeric fields for which to return aggregate statistics (mean, max, min, count).", "schema": { "type": "string" } }, "stock_no": { "name": "stock_no", "in": "query", "description": "Filters listings by dealer stock number.", "schema": { "type": "string" } }, "transmission": { "name": "transmission", "in": "query", "description": "Filters listings by transmission type (`Automatic`, `Manual`, etc.). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "trim": { "name": "trim", "in": "query", "description": "Filters listings by vehicle trim (e.g., `EX`, `Limited`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "vehicle_type": { "name": "vehicle_type", "in": "query", "description": "Filters listings by vehicle type (`Truck`, `Car`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "version": { "name": "version", "in": "query", "description": "Filters listings by vehicle version name.", "schema": { "type": "string" } }, "vin": { "name": "vin", "in": "query", "description": "Filters listings by full 17-character Vehicle Identification Number (VIN).", "schema": { "type": "string" } }, "year": { "name": "year", "in": "query", "description": "Filters listings by model year (e.g., `2020`). Accepts multiple years separated by commas.", "schema": { "type": "string" } }, "has_price": { "name": "has_price", "in": "query", "description": "Boolean param to filter listings that have a price (true) or no price (false).", "schema": { "type": "boolean" } }, "has_miles": { "name": "has_miles", "in": "query", "description": "Boolean param to filter listings that have a miles (true) or no miles (false).", "schema": { "type": "boolean" } }, "year_range": { "name": "year_range", "in": "query", "description": "Filters listings by model year range. Specify as `min-max` (e.g., `2015-2025`).", "schema": { "type": "string" } }, "fields": { "name": "fields", "in": "query", "description": "Comma-separated list of fields to include in History API response.", "schema": { "type": "string" } }, "page": { "name": "page", "in": "query", "description": "Page number for paginated History API results. Default — 1.", "schema": { "type": "integer" } }, "sort_order_v2": { "name": "sort_order", "in": "query", "description": "Specifies result sort order for historical data. Allowed values — `asc` or `desc`. Default — `desc`.", "schema": { "type": "string", "default": "desc" } }, "redirect_to_active": { "name": "redirect_to_active", "in": "query", "description": "If `true`, redirects to the active version of the listing if it has been updated.", "schema": { "type": "boolean" } }, "redirect_to_latest": { "name": "redirect_to_latest", "in": "query", "description": "If `true`, redirects to the latest version of the listing if it has been updated.", "schema": { "type": "boolean" } }, "carfax_1_owner": { "name": "carfax_1_owner", "in": "query", "description": "If `true`, returns only vehicles with a single previous owner; if `false` or omitted, no ownership filter is applied. Default — false.", "schema": { "type": "boolean" } }, "carfax_clean_title": { "name": "carfax_clean_title", "in": "query", "description": "If `true`, returns only vehicles with a clean title history; if `false` or omitted, no title filter is applied. Default — false.", "schema": { "type": "boolean" } }, "debug": { "name": "debug", "in": "query", "description": "If `true`, returns applied year, make, model, and trim filters in the response. Default — false.", "schema": { "type": "boolean", "default": false } }, "exact": { "name": "exact", "in": "query", "description": "If `true`, performs exact matching (upto build_code level) in MDS API queries. If `false`, performs partial matching (upto model level). Default — false.", "schema": { "type": "boolean", "default": false } }, "exclude_certified": { "name": "exclude_certified", "in": "query", "description": "If `true`, excludes certified-pre-owned vehicles from results. Default — false. See `car_type` parameter for filtering by inventory type for certified vehicles.", "schema": { "type": "boolean" } }, "finance_down_payment": { "name": "finance_down_payment", "in": "query", "description": "Filters listings by finance down-payment amount in USD. Specify a single value or a `min-max` range.", "schema": { "type": "string" } }, "finance_down_payment_per": { "name": "finance_down_payment_per", "in": "query", "description": "Filters listings by finance down-payment percentage. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "finance_emp": { "name": "finance_emp", "in": "query", "description": "Filters listings by finance Estimated Monthly Payment (EMP) in USD. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "finance_loan_apr": { "name": "finance_loan_apr", "in": "query", "description": "Filters listings by finance loan APR. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "finance_loan_term": { "name": "finance_loan_term", "in": "query", "description": "Filters listings by finance loan term in months. Specify a single value or `min-max` months.", "schema": { "type": "string" } }, "include_sold": { "name": "include_sold", "in": "query", "description": "If `true`, includes array of sold VINs in MDS API responses. Default — false.", "schema": { "type": "boolean", "default": false } }, "lease_down_payment": { "name": "lease_down_payment", "in": "query", "description": "Filters listings by lease down-payment amount in USD. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "lease_emp": { "name": "lease_emp", "in": "query", "description": "Filters listings by lease Estimated Monthly Payment (EMP) in USD. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "lease_term": { "name": "lease_term", "in": "query", "description": "Filters listings by lease term length in months. Specify a single value or `min-max`.", "schema": { "type": "string" } }, "ymmt": { "name": "ymmt", "in": "query", "description": "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.", "schema": { "type": "string" } }, "car_type_v2": { "name": "car_type", "in": "query", "required": true, "description": "Inventory status for popular cars statistics. Allowed values — `new`, `used`. Required.", "schema": { "type": "string" } }, "state_v3": { "name": "state", "in": "query", "description": "Filters popular cars statistics by US state code. 2-letter code (e.g., `FL`, `CA`).", "schema": { "type": "string" } }, "city_state": { "name": "city_state", "in": "query", "description": "City and state for popular cars statistics, pipe-separated (e.g., `jacksonville|FL`).", "schema": { "type": "string" } }, "country_v4": { "name": "country", "in": "query", "description": "Country for popular car queries (`us` or `ca`). Default — `us`.", "schema": { "type": "string", "default": "us" } }, "city_v3": { "name": "city", "in": "query", "description": "City of the vehicle location. Either `zip` or `city` and `state` must be provided for price prediction.", "schema": { "type": "string" } }, "dealer_type_v2": { "name": "dealer_type", "in": "query", "required": true, "description": "Dealer type for price prediction. Allowed values — `franchise`, `independent`. Required.", "schema": { "type": "string" } }, "is_certified": { "name": "is_certified", "in": "query", "description": "If `true`, treats the vehicle as certified for price prediction. Default — false.", "schema": { "type": "boolean", "default": false } }, "miles": { "name": "miles", "in": "query", "required": true, "description": "Current mileage of the vehicle. Required for price prediction.", "schema": { "type": "integer" } }, "state_v4": { "name": "state", "in": "query", "description": "State of the vehicle location (2-letter code, e.g. `CA`). Either `zip` or `city` and `state` must be provided for price prediction.", "schema": { "type": "string" } }, "vin_v2": { "name": "vin", "in": "query", "required": true, "description": "VIN of the car for MarketCheck price prediction (17 characters). Required.", "schema": { "type": "string" } }, "zip_v2": { "name": "zip", "in": "query", "description": "ZIP code of the vehicle location. Either `zip` or `city` and `state` must be provided for price prediction.", "schema": { "type": "string" } }, "vrm": { "name": "vrm", "in": "query", "required": true, "description": "VRM of the vehicle for MarketCheck price prediction. Required.", "schema": { "type": "string" } }, "postal_code_v2": { "name": "postal_code", "in": "query", "required": true, "description": "Postal code of the vehicle location. Required.", "schema": { "type": "string" } }, "make_v2": { "name": "make", "in": "query", "description": "The vehicle make for sales statistics queries.", "schema": { "type": "string" } }, "mm": { "name": "mm", "in": "query", "description": "The Make-Model (`mm`) combination for sales statistics, pipe-separated (e.g., `ford|f-150`).", "schema": { "type": "string" } }, "ymm": { "name": "ymm", "in": "query", "description": "Year-Make-Model (`ymm`) group for sales statistics, pipe-separated (e.g., `2015|ford|f-150`).", "schema": { "type": "string" } }, "ymmt_v2": { "name": "ymmt", "in": "query", "description": "Year-Make-Model-Trim (`ymmt`) combination for sales statistics, pipe-separated.", "schema": { "type": "string" } }, "taxonomy_vin": { "name": "taxonomy_vin", "in": "query", "description": "The taxonomy VIN (aka squish VIN) for sales statistics queries.", "schema": { "type": "string" } }, "vin_v3": { "name": "vin", "in": "query", "description": "The full VIN (17 characters) to be transformed into a taxonomy VIN for statistics.", "schema": { "type": "string" } }, "state_v5": { "name": "state", "in": "query", "description": "US state code for state-level sales statistics. 2-letter code (e.g., `FL`, `CA`).", "schema": { "type": "string" } }, "city_state_v2": { "name": "city_state", "in": "query", "description": "City and state for city-level sales statistics, pipe-separated (e.g., `jacksonville|FL`).", "schema": { "type": "string" } }, "country_v5": { "name": "country", "in": "query", "description": "Country for which to retrieve sales statistics. Allowed values — `us`, `ca`. Default — `us`.", "schema": { "type": "string", "default": "us" } }, "dedup": { "name": "dedup", "in": "query", "description": "If `true`, returns only `is_searchable` listings irrespective of `dealer_id`, `mc_website_id`, or `source`. Default — false. See `nodedup` for the opposite behavior.", "schema": { "type": "boolean" } }, "exclude_dealer_ids": { "name": "exclude_dealer_ids", "in": "query", "description": "Excludes results from the specified dealer IDs. Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "exclude_high_value_features": { "name": "exclude_high_value_features", "in": "query", "description": "Excludes listings that contain any of the specified High-Value Features (HVFs). Accepts comma-separated HVFs.", "schema": { "type": "string" } }, "exclude_make": { "name": "exclude_make", "in": "query", "description": "Excludes the specified makes. Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "exclude_mc_website_ids": { "name": "exclude_mc_website_ids", "in": "query", "description": "Excludes results from the specified MarketCheck website IDs. Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "exclude_options_packages": { "name": "exclude_options_packages", "in": "query", "description": "Excludes listings containing the specified Options Packages (OPs). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "exclude_sources": { "name": "exclude_sources", "in": "query", "description": "Excludes listings from the specified sources (e.g., `autonation.com`, `carmax.com`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "high_value_features": { "name": "high_value_features", "in": "query", "description": "Filters listings that include all specified High-Value Features (HVFs). Provide HVFs as a comma-separated list.", "schema": { "type": "string" } }, "include_finance": { "name": "include_finance", "in": "query", "description": "If `true`, only listings with finance offers are returned. Default — false.", "schema": { "type": "boolean" } }, "include_lease": { "name": "include_lease", "in": "query", "description": "If `true`, only listings with lease offers are returned. Default — false.", "schema": { "type": "boolean" } }, "include_preferred_dealer_flag": { "name": "include_preferred_dealer_flag", "in": "query", "description": "If `true`, adds a `preferred_dealer` flag to listings when they match client-specific filters. Default — false.", "schema": { "type": "boolean", "default": false } }, "inventory_count_range": { "name": "inventory_count_range", "in": "query", "description": "Filters dealers by total listing count. Specify as `min-max` listings (e.g., `10-100`).", "schema": { "type": "string" } }, "match": { "name": "match", "in": "query", "description": "Comma-separated list of field names for exact matching in combination with `vins`. Allowed values — year, make, model, trim, version, build_code, options_packages. Example: `year,make,model` or `year,make,model,trim,version`.", "schema": { "type": "string" } }, "mm_v2": { "name": "mm", "in": "query", "description": "Make-Model composite string from the auto-complete API. Pass the value exactly as returned (e.g., `toyota|camry`).", "schema": { "type": "string" } }, "nodedup": { "name": "nodedup", "in": "query", "description": "If `true`, returns all duplicate listings for a VIN; if `false` (default), duplicate listings are removed. This is the opposite of `dedup`.", "schema": { "type": "boolean" } }, "options_packages": { "name": "options_packages", "in": "query", "description": "Filters listings by Options Packages (OPs). Provide a comma-separated list; results include listings containing all specified OPs.", "schema": { "type": "string" } }, "plot": { "name": "plot", "in": "query", "description": "If `true`, returns up to 1000 listings for plotting instead of full listing details.", "schema": { "type": "boolean" } }, "preferred_dealers": { "name": "preferred_dealers", "in": "query", "description": "If `true`, flags listings in response from preferred dealers based on client scoring. Default — false.", "schema": { "type": "boolean", "default": false } }, "preferred_dealers_only": { "name": "preferred_dealers_only", "in": "query", "description": "If `true`, returns listings only from preferred dealers. Default — false.", "schema": { "type": "boolean", "default": false } }, "price_change": { "name": "price_change", "in": "query", "description": "Filters listings by positive or negative price-change flag (e.g., `positive`, `negative`). Accepts multiple comma-separated values.", "schema": { "type": "string" } }, "price_change_range": { "name": "price_change_range", "in": "query", "description": "Filters listings by the price change in USD. Since price changes can be positive or negative, specify as `min|max` (e.g., `-5000|1000`). This is a range filter.", "schema": { "type": "string" } }, "taxonomy_vins": { "name": "taxonomy_vins", "in": "query", "description": "Comma-separated list of 10-character “squish” VINs (first 8 + 10th & 11th chars). Filters listings by build.", "schema": { "type": "string" } }, "vdp_url": { "name": "vdp_url", "in": "query", "description": "Filters listings by Vehicle Detail Page (VDP) URL match.", "schema": { "type": "string" } }, "vins": { "name": "vins", "in": "query", "description": "The VINs to find similar cars around. Accepts a comma-separated list of VINs. Used in conjunction with the `match` parameter always. Similar parameters are `ymmt` and `taxonomy_vins`.", "schema": { "type": "string" } }, "ymm_v2": { "name": "ymm", "in": "query", "description": "Year-Make-Model composite string from auto-completion (e.g., `2019|Toyota|Camry`).", "schema": { "type": "string" } }, "vehicle_status": { "name": "vehicle_status", "in": "query", "description": "Filters listings by vehicle status (e.g., `Available`, `Coming Soon`).", "schema": { "type": "string" } }, "buy_now_price_range": { "name": "buy_now_price_range", "in": "query", "description": "Filters listings by advertised buy now price in USD. Specify as `min-max` (e.g., `1000-50000`).", "schema": { "type": "string" } }, "facet_min_count": { "name": "facet_min_count", "in": "query", "description": "Minimum document count for a facet bucket to be returned.", "schema": { "type": "integer" } }, "field": { "name": "field", "in": "query", "description": "The field name for which to perform auto-completion.", "schema": { "type": "string" } }, "ignore_case": { "name": "ignore_case", "in": "query", "description": "If `true`, the auto-complete search is case-insensitive. Default — true.", "schema": { "type": "boolean", "default": true } }, "input": { "name": "input", "in": "query", "description": "The text input string used for auto-completion queries.", "schema": { "type": "string" } }, "seller_type": { "name": "seller_type", "in": "query", "description": "Filters auto-complete suggestions by seller type. Allowed values — `dealer`, `fsbo`, `auction`.", "schema": { "type": "string" } }, "term_counts": { "name": "term_counts", "in": "query", "description": "If `true`, includes term frequency counts in the response. Default — false.", "schema": { "type": "boolean", "default": false } }, "acquisition_fee_range": { "name": "acquisition_fee_range", "in": "query", "description": "Filters listings by acquisition fee amount. Specify as `min-max` in USD (e.g., `500-1500`).", "schema": { "type": "string" } }, "apr_range": { "name": "apr_range", "in": "query", "description": "Filters listings by Annual Percentage Rate (APR). Specify as `min-max` (e.g., `0-9.99`).", "schema": { "type": "string" } }, "base_sha": { "name": "base_sha", "in": "query", "description": "The SHA-256 hash of an incentive offer used as the comparison baseline.", "schema": { "type": "string" } }, "cashback_amount_range": { "name": "cashback_amount_range", "in": "query", "description": "Filters listings by cashback amount specified in the offer. Specify as `min-max` in USD.", "schema": { "type": "string" } }, "cashback_target_group": { "name": "cashback_target_group", "in": "query", "description": "Filters cashback offers by target group (e.g. `Military personnel`, `College graduates`). Accepts multiple groups as comma-separated values.", "schema": { "type": "string" } }, "dealer_contribution_range": { "name": "dealer_contribution_range", "in": "query", "description": "Filters listings by dealer contribution amount in USD. Specify as `min-max` (e.g., `1000-5000`).", "schema": { "type": "string" } }, "disposition_fee_range": { "name": "disposition_fee_range", "in": "query", "description": "Filters listings by lease disposition fee in USD. Specify as `min-max`. (e.g., `0-500`).", "schema": { "type": "string" } }, "down_payment_range": { "name": "down_payment_range", "in": "query", "description": "Filters finance or lease offers by down-payment amount in USD. Specify as `min-max`.", "schema": { "type": "string" } }, "due_at_signing_range": { "name": "due_at_signing_range", "in": "query", "description": "Filters lease offers by “due at signing” amount in USD (sum of first month, down payment, acquisition fee). Specify as `min-max`. (e.g., `0-500`).", "schema": { "type": "string" } }, "gross_cap_cost_range": { "name": "gross_cap_cost_range", "in": "query", "description": "Filters listings by gross capitalized cost in USD. Specify as `min-max`.", "schema": { "type": "string" } }, "lease_end_purchase_price_range": { "name": "lease_end_purchase_price_range", "in": "query", "description": "Filters lease offers by residual value (purchase price at lease end) in USD. Specify as `min-max`.", "schema": { "type": "string" } }, "mileage_limit_range": { "name": "mileage_limit_range", "in": "query", "description": "Filters offers by mileage limit specified in lease terms. Specify as `min-max` miles.", "schema": { "type": "string" } }, "monthly_range": { "name": "monthly_range", "in": "query", "description": "Filters listings by monthly payment amount in USD (commonly in lease offers). Specify as `min-max` (e.g., `200-500`).", "schema": { "type": "number" } }, "net_cap_cost_range": { "name": "net_cap_cost_range", "in": "query", "description": "Filters listings by net capitalized cost in USD (post-discount lease amount). Specify as `min-max`.", "schema": { "type": "number" } }, "offer_type": { "name": "offer_type", "in": "query", "description": "Filters incentive offers by type. Allowed values — `lease`, `finance`, `cash`.", "schema": { "type": "string" } }, "over_mileage_fee_range": { "name": "over_mileage_fee_range", "in": "query", "description": "Filters lease offers by per-mile surcharge for exceeding included mileage. Specify as `min-max` USD.", "schema": { "type": "number" } }, "scraped_at_date_range": { "name": "scraped_at_date_range", "in": "query", "description": "Filters listings by the first seen date. Specify as `YYYYMMDD-YYYYMMDD`. Alias for `first_seen_range`.", "schema": { "type": "string" } }, "search_disclaimers_text": { "name": "search_disclaimers_text", "in": "query", "description": "Full-text search within offer disclaimers.", "schema": { "type": "string" } }, "search_offers_text": { "name": "search_offers_text", "in": "query", "description": "Full-text search within offer descriptions.", "schema": { "type": "string" } }, "search_titles_text": { "name": "search_titles_text", "in": "query", "description": "Full-text search within listing titles.", "schema": { "type": "string" } }, "security_deposit_range": { "name": "security_deposit_range", "in": "query", "description": "Filters lease offers by security deposit amount in USD. Specify as `min-max`.", "schema": { "type": "number" } }, "status_date_range": { "name": "status_date_range", "in": "query", "description": "Filters offers by last seen date. Specify as `YYYYMMDD-YYYYMMDD`.", "schema": { "type": "string" } }, "term_range": { "name": "term_range", "in": "query", "description": "Filters finance/lease offers by term length. Specify as `min-max` numeric value; units defined by `term_unit`.", "schema": { "type": "number" } }, "term_unit": { "name": "term_unit", "in": "query", "description": "Units for `term_range`. Allowed values — `month`, `year`.", "schema": { "type": "string" } }, "total_monthly_payments_range": { "name": "total_monthly_payments_range", "in": "query", "description": "Filters lease offers by total monthly payments over the term in USD. Specify as `min-max`.", "schema": { "type": "number" } }, "valid_from_range": { "name": "valid_from_range", "in": "query", "description": "Filters offers by “valid from” date. Specify as `YYYYMMDD-YYYYMMDD`.", "schema": { "type": "string" } }, "valid_through_range": { "name": "valid_through_range", "in": "query", "description": "Filters offers by “valid through” date. Specify as `YYYYMMDD-YYYYMMDD`.", "schema": { "type": "string" } }, "active_inventory_date_range": { "name": "active_inventory_date_range", "in": "query", "description": "Filters listings active at least once within the specified date range. Specify as `YYYYMMDD-YYYYMMDD` (e.g., `20190523-20190623`).", "schema": { "type": "string" } }, "expired": { "name": "expired", "in": "query", "description": "If `true`, returns listings of expired VINs (i.e., VINs that are no longer active in the market for sale); if `false`, returns expired listings of VINs that are still active.", "schema": { "type": "boolean" } }, "sold": { "name": "sold", "in": "query", "description": "If `true`, returns listings that are inferred to be sold by MarketCheck.", "schema": { "type": "boolean" } }, "append_api_key_v2": { "name": "append_api_key", "in": "query", "description": "If `true`, the response URLs (such as cached images & relevant links) include the `api_key` query parameter along with value; if `false`, they do not. Default — `false`.", "schema": { "type": "boolean", "default": false } }, "car_location_city": { "name": "car_location_city", "in": "query", "description": "City of the car location. Used for filtering by specific car location city.", "schema": { "type": "string" } }, "car_location_county": { "name": "car_location_county", "in": "query", "description": "County of the car location. Used for filtering by specific car location county.", "schema": { "type": "string" } }, "car_location_latitude": { "name": "car_location_latitude", "in": "query", "description": "Latitude of the car location (decimal degrees). Used for geospatial queries of car location.", "schema": { "type": "number" } }, "car_location_longitude": { "name": "car_location_longitude", "in": "query", "description": "Longitude of the car location (decimal degrees). Used for geospatial queries of car location.", "schema": { "type": "number" } }, "car_location_seller_name": { "name": "car_location_seller_name", "in": "query", "description": "Seller name at car location. Used for filtering by specific seller name at car location.", "schema": { "type": "string" } }, "car_location_street": { "name": "car_location_street", "in": "query", "description": "Street address of the car location. Used for filtering by specific car location street address.", "schema": { "type": "string" } }, "car_location_zip": { "name": "car_location_zip", "in": "query", "description": "Postal code of the car location. Used for filtering by specific car location postal code.", "schema": { "type": "string" } }, "co2_emissions": { "name": "co2_emissions", "in": "query", "description": "Filters listings by CO2 emissions rating in g/km. Specify as a single value or `min-max` range (e.g., `0-120`).", "schema": { "type": "string" } }, "combined_mpg_range": { "name": "combined_mpg_range", "in": "query", "description": "Filters listings by combined fuel-economy mileage. Specify as `min-max` MPG (e.g., `40-65`).", "schema": { "type": "string" } }, "country_v6": { "name": "country", "in": "query", "description": "Filters listings by UK country code. Allowed values - `uk`, `england`, `scotland`, `wales`, `northern_ireland`.", "schema": { "type": "string" } }, "ev_battery_capacity_range": { "name": "ev_battery_capacity_range", "in": "query", "description": "Filters electric vehicles by battery capacity. Specify as `min-max` kWh (e.g., `40-100`).", "schema": { "type": "string" } }, "ev_battery_type": { "name": "ev_battery_type", "in": "query", "description": "Filters electric vehicles by battery type (e.g., `Lithium-ion`, `Nickel-metal hydride`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "ev_vehicle_range": { "name": "ev_vehicle_range", "in": "query", "description": "Filters electric vehicles by driving range. Specify as a single value or `min-max` miles (e.g., `200-400`).", "schema": { "type": "string" } }, "exclude_sources_v2": { "name": "exclude_sources", "in": "query", "description": "Excludes listings from the specified sources (e.g., `arnoldclark.com`, `cinch.co.uk`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "exclude_write_off_category": { "name": "exclude_write_off_category", "in": "query", "description": "Excludes listings with specified write-off categories (e.g., `Category A`, `Category B`, `Category S`, `Category N`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "fuel_type_v2": { "name": "fuel_type", "in": "query", "description": "Filters listings by fuel type (e.g., `Petrol`, `Diesel`, `Electric`, `Petrol Electric Hybrid`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "insurance_group": { "name": "insurance_group", "in": "query", "description": "Filters listings by UK insurance group rating (e.g., `E`, `15E`, etc). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "is_vat_included": { "name": "is_vat_included", "in": "query", "description": "If `true`, returns listings where VAT is included in the price; if `false`, returns listings where VAT is excluded. Default — no filter applied.", "schema": { "type": "boolean" } }, "match_v2": { "name": "match", "in": "query", "description": "Comma-separated list of field names for exact matching in combination with `vrm`. Allowed values — `year`,`make`,`model`,`variant`,`body_type`,`drivetrain`,`transmission`,`fuel_type`.", "schema": { "type": "string" } }, "model_variant": { "name": "model_variant", "in": "query", "description": "Filters listings by specific vehicle model variant (e.g., `320d M Sport`, `C220d AMG Line`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "msrp_range_v2": { "name": "msrp_range", "in": "query", "description": "Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as `min-max` GBP (e.g., `20000-45000`).", "schema": { "type": "string" } }, "nodedup_v2": { "name": "nodedup", "in": "query", "description": "If `true`, returns all duplicate listings for a VRM; if `false` (default), duplicate listings are removed. This is the opposite of `dedup`.", "schema": { "type": "boolean" } }, "num_owners": { "name": "num_owners", "in": "query", "description": "Filters listings by number of previous owners.", "schema": { "type": "string" } }, "performance_co2_range": { "name": "performance_co2_range", "in": "query", "description": "Filters listings by CO2 performance rating. Specify as `min-max` range (e.g., `0-150`).", "schema": { "type": "string" } }, "powertrain_type_v2": { "name": "powertrain_type", "in": "query", "description": "Filters listings by powertrain type. Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "price_change_range_v2": { "name": "price_change_range", "in": "query", "description": "Filters listings by the price change in GBP. Since price changes can be positive or negative, specify as `min|max` (e.g., `-5000|1000`). This is a range filter.", "schema": { "type": "string" } }, "price_range_v2": { "name": "price_range", "in": "query", "description": "Filters listings by advertised price in GBP. Specify as `min-max` (e.g., `1000-50000`).", "schema": { "type": "string" } }, "source_v2": { "name": "source", "in": "query", "description": "Filters listings by website domain (e.g., `arnoldclark.com`, `cinch.co.uk`).", "schema": { "type": "string" } }, "state_v6": { "name": "state", "in": "query", "description": "Alias for `county`. Filters listings by state/county (e.g., `Greater London`, `Lincolnshire`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "trim_v2": { "name": "trim", "in": "query", "description": "Alias of `variant`. Filters listings by vehicle trim (e.g., `EX`, `Limited`). Use `variant` instead. Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "ulez_compliant": { "name": "ulez_compliant", "in": "query", "description": "If `true`, returns listings that are ULEZ (Ultra Low Emission Zone) compliant. Default — false.", "schema": { "type": "boolean" } }, "uvc_id": { "name": "uvc_id", "in": "query", "description": "Filters listings by Unique Vehicle Code identifier. Used for matching specific vehicle configurations.", "schema": { "type": "string" } }, "variant": { "name": "variant", "in": "query", "description": "Alias of `trim`. Filters listings by vehicle variant identifier. Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "vehicle_registration_date_range": { "name": "vehicle_registration_date_range", "in": "query", "description": "Filters listings by vehicle registration date. Specify as `YYYYMMDD-YYYYMMDD` (e.g., `20200101-20231231`).", "schema": { "type": "string" } }, "vehicle_registration_mark": { "name": "vehicle_registration_mark", "in": "query", "description": "Alias of `vrm`. Filters listings by Vehicle Registration Mark (VRM/number plate). Use instead of `vrm`. Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "vrm_v2": { "name": "vrm", "in": "query", "description": "Filters listings by Vehicle Registration Mark (VRM/number plate). Use instead of `vehicle_registration_mark`. Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "wheelbase_category": { "name": "wheelbase_category", "in": "query", "description": "Filters listings by wheelbase category (e.g., `SWB`, `LWB`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "write_off_category": { "name": "write_off_category", "in": "query", "description": "Filters listings by write-off category classification (e.g., `Category A`, `Category B`, `Category S`, `Category N`). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "ymmt_v3": { "name": "ymmt", "in": "query", "description": "Year-Make-Model-Trim composite string(s). Each combo uses pipe separators and combinations can be comma-separated. For example, `2019|Ford|Fiesta|Zetec,2020|Ford|Fiesta|St-line`. Useful for finding multiple groups of similar cars. Alternatively, you can use `vrm` and `match` for VRM-based queries.", "schema": { "type": "string" } }, "expired_v2": { "name": "expired", "in": "query", "description": "If `true`, returns listings of expired VRMs (i.e., VRMs that are no longer active in the market for sale); if `false`, returns expired listings of VRMs that are still active.", "schema": { "type": "boolean" } }, "category": { "name": "category", "in": "query", "description": "Filters listings by Heavy Equipment category (e.g. `Agriculture`, `Construction`, `Crane`). Accepts multiple categories as comma-separated values.", "schema": { "type": "string" } }, "hours_used_range": { "name": "hours_used_range", "in": "query", "description": "Filters listings by hours used in the case of Heavy Equipment. Specify as `min-max` hours (e.g., `100-500`).", "schema": { "type": "string" } }, "inventory_type": { "name": "inventory_type", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "search_text": { "name": "search_text", "in": "query", "description": "Text substring search within listing titles, descriptions, and other fields. Use `tokenized_search_text` instead for tokenized search.", "schema": { "type": "string" } }, "sub_category": { "name": "sub_category", "in": "query", "description": "Filters RV listings by their sub-category (e.g., `Travel Trailer`, `Fifth Wheel`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "color": { "name": "color", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "motorcycle_taxonomy_vin": { "name": "motorcycle_taxonomy_vin", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "type": { "name": "type", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "class": { "name": "class", "in": "query", "description": "Filters listings by RV class type (e.g., `Class A`, `Class B`, `Class C`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "fresh_water_capacity": { "name": "fresh_water_capacity", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "gvwr": { "name": "gvwr", "in": "query", "description": "Filters listings by Gross Vehicle Weight Rating (GVWR) in pounds. Specify as a single value or `min-max` range (e.g., `5000-10000`).", "schema": { "type": "string" } }, "length": { "name": "length", "in": "query", "description": "Filters listings by vehicle length in inches.", "schema": { "type": "string" } }, "length_range": { "name": "length_range", "in": "query", "description": "Filters listings by vehicle length in inches. Specify as `min-max` inches (e.g., `150-250`).", "schema": { "type": "string" } }, "model_o": { "name": "model_o", "in": "query", "description": "Filters listings by model orig (as described on the webpage). Accepts multiple values as comma-separated list.", "schema": { "type": "string" } }, "number_of_awnings": { "name": "number_of_awnings", "in": "query", "description": "Filters listings by the number of awnings. Accepts multiple values as a comma-separated list.", "schema": { "type": "integer" } }, "slideouts": { "name": "slideouts", "in": "query", "description": "Filters listings by the number of slideouts. Accepts multiple values as a comma-separated list.", "schema": { "type": "integer" } }, "sleeps": { "name": "sleeps", "in": "query", "description": "Filters listings by the number of sleeping areas. Specify as min-max range (e.g., `1-4`).", "schema": { "type": "integer" } }, "tokenized_search_text": { "name": "tokenized_search_text", "in": "query", "description": "Tokenized search within listing titles, descriptions, and other fields. Use this instead of `search_text` for exact matches.", "schema": { "type": "string" } }, "sort_by_v2": { "name": "sort_by", "in": "query", "description": "Field to sort RV auto-complete results. Allowed values - `index` (default) or `count`.", "schema": { "type": "string" } }, "availability_status": { "name": "availability_status", "in": "query", "description": "Filters listings by their availability status (e.g., `Due in`, `sold`, `pending`). Accepts multiple statuses as a comma-separated list.", "schema": { "type": "string" } }, "berths": { "name": "berths", "in": "query", "description": "Filters listings by the number of berths in the RV (e.g., `2`, `4`, `6`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "category_v2": { "name": "category", "in": "query", "description": "(not in registry)", "schema": { "type": "string" } }, "chassis": { "name": "chassis", "in": "query", "description": "Filters listings by chassis type (e.g. `Ford`, `Chevrolet`, `Mercedes-Benz`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "drive_type": { "name": "drive_type", "in": "query", "description": "Filters listings by drive type (e.g., `AWD`, `FWD`, `RWD`, `4WD`). Accepts multiple values as a comma-separated list.", "schema": { "type": "string" } }, "exterior_length_range": { "name": "exterior_length_range", "in": "query", "description": "Filters listings by exterior length in inches. Specify as `min-max` inches (e.g., `150-250`).", "schema": { "type": "string" } }, "interior_length_range": { "name": "interior_length_range", "in": "query", "description": "Filters listings by interior length in inches. Specify as `min-max` inches (e.g., `100-200`).", "schema": { "type": "string" } }, "mtplm": { "name": "mtplm", "in": "query", "description": "Filters listings by Maximum Technically Permissible Laden Mass (MTPLM) in pounds.", "schema": { "type": "string" } }, "steering": { "name": "steering", "in": "query", "description": "Filters listings by steering type (e.g., `power steering`). Accepts multiple values separated by commas.", "schema": { "type": "string" } }, "width_range": { "name": "width_range", "in": "query", "description": "Filters listings by vehicle width in inches. Specify as `min-max` inches (e.g., `60-80`).", "schema": { "type": "string" } } }, "headers": { "RateLimit-Limit": { "description": "Requests allowed per second on your plan.", "schema": { "type": "integer" } }, "RateLimit-Remaining": { "description": "Requests remaining in the current rate window.", "schema": { "type": "integer" } }, "RateLimit-Reset-Time": { "description": "When the rate window resets.", "schema": { "type": "string" } }, "Quota-Limit": { "description": "Monthly call quota on your plan.", "schema": { "type": "integer" } }, "Quota-Remaining": { "description": "Calls remaining in the current month.", "schema": { "type": "integer" } }, "Quota-Reset-Time": { "description": "When the monthly quota resets (ISO timestamp).", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds to wait before retrying. Can be large when the monthly quota, not the per-second rate, is exhausted.", "schema": { "type": "integer" } } }, "responses": { "Error401": { "description": "Missing or invalid api_key." }, "Error404": { "description": "No resource with that identifier." }, "Error422": { "description": "Validation error, including paging past the plan's deep-pagination limit (treat as end of results)." }, "Error429": { "description": "Rate limit or monthly quota exceeded. Honor Retry-After; distinguish RateLimit-* (per-second) from Quota-* (per-month) headers.", "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" }, "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" }, "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" }, "Quota-Remaining": { "$ref": "#/components/headers/Quota-Remaining" }, "Quota-Reset-Time": { "$ref": "#/components/headers/Quota-Reset-Time" } } } } } }