UK Cars / Inventory

Past Inventory Search

get/search/car/uk/recents

Request

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

Query parameters

active_inventory_date_rangestring

Filters listings active at least once within the specified date range. Specify as YYYYMMDD-YYYYMMDD (e.g., 20190523-20190623).

append_api_keyboolean

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.

base_ext_colorstring

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

base_exterior_colorstring

Alias for base_ext_color. Filters by base exterior color (comma-separated list).

base_int_colorstring

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

base_interior_colorstring

Alias for base_int_color. Filters by base interior color (comma-separated list).

body_subtypestring

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

body_typestring

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

car_typestring

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

citystring

Filters listings by city name (e.g. London, Derby, Birmingham).

city_mpg_rangestring

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

combined_mpg_rangestring

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

countrystring

Filters listings by UK country code. Allowed values - uk, england, scotland, wales, northern_ireland.

countystring

Filters listings by county name (e.g. Greater London, Lancashire). Use instead of state. Accepts multiple counties as comma-separated values.

cylindersstring

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

dealer_idstring

Filters listings by MarketCheck dealer ID.

dealer_namestring

Filters listings by dealer name (case-insensitive complete match, substring not supported).

dealer_typestring

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

dealership_group_namestring

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

dedupboolean

If true, returns only is_searchable listings irrespective of dealer_id, mc_website_id, or source. Default — false. See nodedup for the opposite behavior.

dom_180_rangestring

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

dom_active_rangestring

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

dom_rangestring

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

doorsstring

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

dos_active_rangestring

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

drivetrainstring

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

enginestring

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

engine_aspirationstring

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

engine_blockstring

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

engine_sizestring

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

engine_size_rangestring

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

exclude_certifiedboolean

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

exclude_dealer_idsstring

Excludes results from the specified dealer IDs. Accepts multiple values as a comma-separated list.

exclude_makestring

Excludes the specified makes. Accepts multiple values as a comma-separated list.

exclude_mc_website_idsstring

Excludes results from the specified MarketCheck website IDs. Accepts multiple values as comma-separated list.

exclude_sourcesstring

Excludes listings from the specified sources (e.g., arnoldclark.com, cinch.co.uk). Accepts multiple values as comma-separated list.

exclude_write_off_categorystring

Excludes listings with specified write-off categories (e.g., Category A, Category B, Category S, Category N). Accepts multiple values as comma-separated list.

expiredboolean

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.

exterior_colorstring

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

facet_sortstring

Sorts facet buckets. Allowed values — count (descending count, default) or index (alphabetical).

facetsstring

Field name to return bucket facets for. Accepts multiple fields as a comma-separated list.

fca_statusstring

FCA authorization status for dealers. (e.g., Authorised, Appointed Representative, Registered). Accepts multiple values as a comma-separated list.

first_seen_at_mc_daysstring

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.

first_seen_at_mc_rangestring

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.

first_seen_at_source_daysstring

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.

first_seen_at_source_rangestring

Filters listings by date first seen on the source site. Specify as YYYYMMDD-YYYYMMDD. Alternative of first_seen_at_source_days.

first_seen_daysstring

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.

first_seen_rangestring

Filters listings by the first seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of first_seen_days.

fuel_typestring

Filters listings by fuel type (e.g., Petrol, Diesel, Electric, Petrol Electric Hybrid). Accepts multiple values separated by commas.

highway_mpg_rangestring

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

include_non_vin_listingsboolean

If true, includes listings without a VIN; if false, such listings are excluded. Default — false.

include_relevant_linksboolean

If true, includes relevant links to other MarketCheck API endpoints in the response. Default — false.

insurance_groupstring

Filters listings by UK insurance group rating (e.g., E, 15E, etc). Accepts multiple values as comma-separated list.

interior_colorstring

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

is_vat_includedboolean

If true, returns listings where VAT is included in the price; if false, returns listings where VAT is excluded. Default — no filter applied.

last_seen_daysstring

Filters listings by the number of days since last seen. Specify as min-max days. Alternative of last_seen_at_range.

last_seen_rangestring

Filters listings by last seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of last_seen_at_days.

latitudestring

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

longitudestring

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

makestring

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

matchstring

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.

mc_categorystring

Filters listings by MarketCheck category code. Case-insensitive.

mc_dealer_idstring

Filters listings by MarketCheck dealer ID.

mc_dealership_group_idstring

Filters listings by MarketCheck dealership group ID.

mc_dealership_group_namestring

Filters listings by dealership group name.

mc_location_idstring

Filters listings by MarketCheck location ID.

mc_rooftop_idstring

Filters listings by MarketCheck rooftop ID.

mc_sub_dealership_group_idstring

Filters listings by MarketCheck sub-dealership group ID.

mc_sub_dealership_group_namestring

Filters listings by sub-dealership group name.

mc_website_idstring

Filters listings by MarketCheck website ID.

miles_rangestring

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

modelstring

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

model_variantstring

Filters listings by specific vehicle model variant (e.g., 320d M Sport, C220d AMG Line). Accepts multiple values as comma-separated list.

nodedupboolean

If true, returns all duplicate listings for a VRM; if false (default), duplicate listings are removed. This is the opposite of dedup.

num_ownersstring

Filters listings by number of previous owners.

ownedboolean

When used with dealer_id, mc_website_id, or source, true returns listings actually owned by that dealer. Default — false.

photo_linksboolean

If true, returns only listings that contain at least one photo link. Default — false.

photo_links_cachedboolean

If true, returns only listings that contain cached photo links. Default — false.

plotboolean

If true, returns up to 1000 listings for plotting instead of full listing details.

postal_codestring

Filters listings within the specified postal code (e.g., M5H 2N2).

price_change_rangestring

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.

price_rangestring

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

radiusinteger

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

range_facetsstring

Comma-separated list of numeric field names for which to return range facets in the response.

rowsinteger

Number of results to return per request. Default — 10. Maximum — 50.

seating_capacitystring

Filters listings by seating capacity (e.g., 2, 5, 7). Accepts multiple values separated by commas.

soldboolean

If true, returns listings that are inferred to be sold by MarketCheck.

sort_bystring

Field to sort results by. If omitted, defaults to distance when a location filter is used.

sort_orderstring

Specifies result sort order. Allowed values — asc or desc. Default — asc.

sourcestring

Filters listings by website domain (e.g., arnoldclark.com, cinch.co.uk).

startinteger

Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/rows.

statestring

Alias for county. Filters listings by state/county (e.g., Greater London, Lincolnshire). Accepts multiple values as a comma-separated list.

statsstring

Comma-separated list of numeric fields for which to return aggregate statistics (mean, max, min, count).

stock_nostring

Filters listings by dealer stock number.

transmissionstring

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

trimstring

Alias of variant. Filters listings by vehicle trim (e.g., EX, Limited). Use variant instead. Accepts multiple values separated by commas.

ulez_compliantboolean

If true, returns listings that are ULEZ (Ultra Low Emission Zone) compliant. Default — false.

variantstring

Alias of trim. Filters listings by vehicle variant identifier. Accepts multiple values as comma-separated list.

vdp_urlstring

Filters listings by Vehicle Detail Page (VDP) URL match.

vehicle_typestring

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

vrmstring

Filters listings by Vehicle Registration Mark (VRM/number plate). Use instead of vehicle_registration_mark. Accepts multiple values as comma-separated list.

wheelbase_categorystring

Filters listings by wheelbase category (e.g., SWB, LWB). Accepts multiple values as comma-separated list.

write_off_categorystring

Filters listings by write-off category classification (e.g., Category A, Category B, Category S, Category N). Accepts multiple values as comma-separated list.

yearstring

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

year_rangestring

Filters listings by model year range. Specify as min-max (e.g., 2015-2025).

ymmtstring

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.

has_priceboolean

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

has_milesboolean

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

Response

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

Changes

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