# API Release - v4.4.0

> New documentation portal, Dealer Inventory Syndication and UK Auto-complete APIs, a higher Basic pagination limit, OAuth token lifecycle endpoints, rate limit headers, and UK API fixes.

- **New features:** New Documentation Portal for Marketcheck API, Dealer Inventory Syndication API, UK Auto-complete API
- **Optimizations:** Enhanced Pagination Limit (Basic Subscription), Support for Dealer & Dealership Parameters in US Active Search API, NeoVIN Enhancements – Available Options Packages, Similar Cars API – Options Packages & Build Code, MDS API – Version & Build Code, Marketcheck Price API – Comparables with Full Attributes, OAuth Token Lifecycle Management, Rate Limit Headers for API Usage Monitoring, OEM Incentives API Enhancements, Support for New Fields in Taxonomy Collection, Allowing Facets by Country in Taxonomy Facets API
- **Other changes:** Deprecation Notice, Dealers Active Inventory API Deprecation, Sunset Notice, Recall API
- **Bug fixes:** Fixed `expired=true` Param Not Respected in UK Recents API, Fixed UK Dealer API Handling for `listing_count_range` Parameter, Fixed UK Dealership API to Include `postal_code` and `county` Filters, Resolved Invalid Latitude/Longitude Validation Issue, Enhanced `in_transit` Parameter to Support Multiple Values



## New features



### 1.New Documentation Portal for Marketcheck API

**Description:**

- Launched a redesigned, modern documentation portal that consolidates all Marketcheck APIs, data feeds, and extensions into a single, user-friendly hub.
- The portal provides improved navigation, comprehensive reference material, and an enhanced developer experience to make integration and discovery faster and more intuitive.
- **Documentation:** [[ MarketCheck Documentation ]](https://docs.marketcheck.com/docs)



### 2. Dealer Inventory Syndication API

**Description:**

- New endpoints introduced to export active dealer inventory in both Marketcheck’s standardised JSON format and marketplace-specific formats, with an increased listings rows limit.

**Pagination Limit Per API Call:** 1500 (supports large dealer inventories).

**Pricing:** $1.50 per API call.

**Endpoints:**

- **Dealer Inventory Syndication**
- **Endpoint:** `/dealerships/inventory`
- Returns standardised JSON dealer inventory with enhanced listings rows limit.
- **Marketplace Inventory Syndication**
- **Endpoint:** `/dealerships/inventory/marketplaces/{marketplace_name}`
- Formats inventory into responses compatible with Facebook and Google Vehicle Ads marketplaces.

**Documentation**

- **API Documentation**
- [[ Dealer Inventory Syndication Documentation ]](https://docs.marketcheck.com/docs/api/cars/dealership-syndication/dealership-inventory)
- [[ Marketplace Inventory Syndication Documentation ]](https://docs.marketcheck.com/docs/api/cars/dealership-syndication/marketplace-inventory)

**Example Requests**

- **Dealer Inventory Syndication**
- `https://api.marketcheck.com/v2/dealerships/inventory?api_key={{api_key}}&source=listedbuy.com`
- **Marketplace Inventory Syndication**
- `https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/facebook?api_key={{api_key}}&dealer_id=1004185`



### 3. UK Auto-complete API

**Description:**

- Implemented real-time auto-completion for UK search inputs leveraging facet capabilities to provide suggestions and result counts across UK vehicle inventory, including UK-specific fields (postal_code, trim, variant) and localised mappings.

**Endpoint:** `/v2/search/car/uk/auto-complete`

**Documentation**

- **API Documentation**
- [[ UK Auto-complete API Documentation ]](https://docs.marketcheck.com/uk/docs/api/cars/inventory/auto-complete)

**Example Request**

- `https://api.marketcheck.com/v2/search/car/uk/auto-complete?api_key={{api_key}}&field=model&make=BMW&input=s`



## Optimizations



### 1. Enhanced Pagination Limit (Basic Subscription)

**Description**

- Pagination limit for **Basic plan** increased from **500 → 1500**.



### 2. Support for Dealer & Dealership Parameters in US Active Search API

**Description**

- Added support for filtering by `dealer_id`, `source`, `mc_website_id`, and Dealerships Management fields. By default, responses include only analytics (stats, facets, range_facets) with `rows=0` and `start=0`.

**Client Impact**

- Enables more precise, dealer-specific level filtering while optimising responses for analytics use cases by default.

**Documentation**

- **API Documentation**
- [[ Dealer & Dealership Parameters in Search API ]](https://docs.marketcheck.com/docs/api/cars/inventory/inventory-search#dealer-inventory-analytics-and-insights)

**Example Requests**

- `https://api.marketcheck.com/v2/search/car/active?api_key={{api_key}}&dealer_id=1004185&stats=price&facets=make,model`



### 3. NeoVIN Enhancements – Available Options Packages

**Description**

- New parameter `include_available_options` enables retrieval of available option packages in decode response.

**Client Impact**

- Clients can now access richer vehicle configuration data directly from NeoVIN decode results.

**Documentation**

- **API Documentation**
- [[ NeoVIN Available Options Packages ]](https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin#vin-decode-with-available-options)

**Example Requests**

- `https://api.marketcheck.com/v2/decode/car/neovin/1FTEW1C59LKE56394/specs?api_key={{api_key}}&include_available_options=true`



### 4. Similar Cars API – Options Packages & Build Code

**Description**

- Expanded matching criteria to include `version`, `options_packages`, and `build_code`, enhancing result accuracy beyond YMMT.

**Client Impact**

- Improves relevancy of similar car results by considering deeper configuration attributes.

**Documentation**

- **API Documentation**
- [[ Similar Cars API Enhancement ]](https://docs.marketcheck.com/docs/api/cars/inventory/inventory-search#similar-cars)

**Example Requests**

- `https://api.marketcheck.com/v2/search/car/active?api_key={{api_key}}&vins=1C4HJWDG3GL147917&match=year,make,model,trim,version,build_code,options_packages`



### 5. MDS API – Version & Build Code

**Description**

- Enhanced exact-match logic: when `exact=true`, MDS values are now calculated using **YMMT + Version + Build Code**.
- Previously, `exact=true` only considered YMMT.

**Client Impact**

- Allows more granular and precise VIN-based matching and more accurate MDS.

**Documentation**

- **API Documentation**
- [[ MDS API Enhancement ]](https://docs.marketcheck.com/docs/api/cars/market-insights/market-days-supply#special-parameters)

**Example Requests**

- `https://api.marketcheck.com/v2/mds/car?api_key={{api_key}}&vin=1HGCM82633A123456&exact=true`



### 6. Marketcheck Price API – Comparables with Full Attributes

**Description**

- Comparables now generated using all vehicle attributes (`YMMT + version + build_code`).

**Client Impact**

- Enhances comparables matching at the most granular attribute level.

**Example Requests**

- `https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables?api_key={{api_key}}&vin=2T3DWRFV3LW077677&miles=76189`



### 7. OAuth Token Lifecycle Management

**Description**

- Introduced new OAuth2 endpoints for token lifecycle management:
- **List Tokens** – retrieve active tokens.
- **Revoke/Delete Tokens** – terminate access immediately.

**Client Impact**

- Provides clients with self-service control over OAuth2 tokens, improving security and compliance.

**Documentation**

- **API Documentation**
- [[ OAuth Token Lifecycle Management ]](https://docs.marketcheck.com/docs/get-started/api/authentication#oauth2-token-lifecycle-management)

**Example Requests**

- **List Tokens:** `https://api.marketcheck.com/oauth2/tokens?api_key={{api_key}}`
- **Revoke Tokens:** POST `https://api.marketcheck.com/oauth2/tokens/revoke`



### 8. Rate Limit Headers for API Usage Monitoring

**Description**

- Standardised rate limit headers added to all API responses to monitor API usage.

**Client Impact**

- Enables clients to track quota usage to better program against rate limit errors and avoid hitting limits unexpectedly.

**Documentation**

- **API Documentation**
- [[ Rate Limit Headers ]](https://docs.marketcheck.com/docs/get-started/api/rate-limit-headers)



### 9. OEM Incentives API Enhancements

**Description**

- Added new fields: `photo_links`, `offer_link` to enrich incentive presentation.

**Client Impact**

- Allows clients to display more complete and visually rich incentive information.

**Example Requests**

- `https://api.marketcheck.com/v2/search/car/incentive/oem?api_key={{api_key}}&rows=1&offer_type=lease&stats=monthly`



### 10. Support for New Fields in Taxonomy Collection

**Description**

- Introduced new fields `powertrain_type` and `version` in Taxonomy collection APIs.

**Client Impact**

- Enables more detailed vehicle classification and filtering.

**Example Requests**

- `https://api.marketcheck.com/v2/specs/car/terms?api_key={{api_key}}&field=powertrain_type|0|20,version|0|20`



### 11. Allowing Facets by Country in Taxonomy Facets API

**Description**

- The Taxonomy Facets API now supports `country` parameter.
- **Default Behaviour**: US + CA combined results.
- Country param: returns country-specific facets.

**Client Impact**

- Supports region-specific business cases (US-only or CA-only analysis).

**Example Requests**

- `https://api.marketcheck.com/v2/specs/car/terms?api_key={{api_key}}&field=trim&make=Volvo&model=XC90&year=2025&country=CA`



## Other changes



## Deprecation Notice



### Dealers Active Inventory API Deprecation

**Description**

- The Dealers Active Inventory API is scheduled for deprecation and full sunset. Clients should migrate to the new **Dealer Inventory Syndication API**.
- **Deprecation:** Mon, 29 Sep 2025 00:00:00 GMT
- **Sunset:** Feb 2026.

**Client Impact**

- Clients will receive deprecation warnings when using the Dealers Active Inventory API starting from Sep 29, 2025.
- The API will be fully unavailable after Feb, 2026, requiring clients to migrate to the Dealer Inventory Syndication API before the sunset date.



## Sunset Notice



### Recall API

**Description**

- The legacy Recall API is deprecated already and sunsetting from 29 Sep, 25; use the AutoRecalls API for improved coverage and accuracy.

**Client Impact**

- Recall API is no longer supported—clients must switch to AutoRecalls API to continue accessing recall data.



## Bug fixes



### 1. Fixed `expired=true` Param Not Respected in UK Recents API

**Description**

- Previously, the UK Recents API was not working as expected for the `expired=true` filter. This has been fixed to correctly filter listings according to the specified parameter.

**Affected Endpoints:** UK Recents Endpoint

**Example API Call**

- `https://api.marketcheck.com/v2/search/car/uk/recents?api_key={{api_key}}&expired=false`



### 2. Fixed UK Dealer API Handling for `listing_count_range` Parameter

**Description**

- Previously, the UK Dealer API was not working as expected for the `listing_count_range` filter. This has been fixed to filter results according to the specified parameter.

**Affected Endpoints:** UK Dealer Endpoint

**Example API Call**

- `https://api.marketcheck.com/v2/dealers/car/uk?api_key={{api_key}}&listing_count_range=10-20`



### 3. Fixed UK Dealership API to Include `postal_code` and `county` Filters

**Description**

- Previously, the UK Dealership API did not properly filter results using `postal_code` and `county`. This has been fixed to ensure dealership listings are filtered and returned accurately.

**Affected Endpoints:** UK Dealership Endpoint

**Example API Call**

- `https://api.marketcheck.com/v2/dealerships/car/uk?api_key={{api_key}}&county=Hertfordshire`



### 4. Resolved Invalid Latitude/Longitude Validation Issue

**Description**

- Previously, API requests with invalid latitude/longitude values resulted in a `500 Internal Server Error`. This has been fixed to properly validate values and return meaningful errors.

**Affected Endpoints:** Inventory Search, Auction, Private Party APIs

**Example API Call**

- `https://api.marketcheck.com/v2/search/car/active?api_key={{api_key}}&car_type=used&latitude=335.218&longitude=-80.840&make=aston` martin&radius=100&rows=100&stats=price,miles



### 5. Enhanced `in_transit` Parameter to Support Multiple Values

**Description**

- Previously, the `in_transit` parameter only supported a single boolean value. This has been updated to accept multiple comma-separated values (`true,false`) for more flexible filtering.

**Affected Endpoints:** All Search Endpoints

**Example API Call**

- `https://api.marketcheck.com/v2/search/car/active?api_key={{api_key}}&in_transit=true,false`