# API Release - v4.5.0

> Documentation chatbot, MarketMatch API, NeoVIN options packages endpoint, webhook and quota alert setup, UK compliance fields, status code based billing, and legacy parameter deprecations.

- **New features:** Chatbot Integration for Marketcheck Documentation Portal, Marketmatch API, Available Options Packages Endpoint (NeoVIN), API Webhook Setup, API Usage Quota Alerts Setup
- **Optimizations:** Rate Limit Enhancement for Standard Subscription, MSA-Level Search Support (Dealer & Dealership APIs), Incentives API – Photo Links Parameter, UK APIs – New Compliance Fields, FSBO & Auction Inventory Filtering Enhancements, Dealership Inventory Syndication – Row Limit Enforcement, UK Search API – Dealer Name Filtering, Status Code–Based API Billing, Comprehensive API Documentation Updates
- **Other changes:** Deprecation of Legacy Request Parameters and Response Fields, Sunset Timeline and Client Impact
- **Bug fixes:** Dealerships API – Error Handling Improvements



## New features



### 1. Chatbot Integration for Marketcheck Documentation Portal

**Description:**

- Launched an AI-powered conversational chatbot integrated into the Marketcheck documentation portal.
- Enables developers to get instant answers, guided integration help, and quick access to relevant API documentation.
- Improves onboarding experience, reduces documentation lookup time, and enhances overall developer productivity.
- Documentation: [[Marketcheck API Chatbot]](https://docs.marketcheck.com/docs)

---



### 2. Marketmatch API

**Description:**

- Introduced the Marketmatch API to provide advanced dealer and vehicle (VIN) ranking analytics.
- Supports data-driven market analysis and informed decision-making using pricing, demand, inventory mix, and location signals.
- Includes dealer ranking and vehicle ranking endpoints for comparative analysis.
- Pricing: $0.35 per API call
- Documentation: [[Marketmatch API Documentation]](https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch)

---



### 3. Available Options Packages Endpoint (NeoVIN)

**Description:**

- Introduced a new endpoint to retrieve all manufacturer option packages for a vehicle using VIN.
- Returns option codes, package names, and MSRP details to support accurate valuation and pricing strategies.
- Endpoint: `/v2/decode/car/neovin/{vin}/options-packages`
- Pricing: $0.02 per API call
- Documentation: [[Available Options Packages API Documentation]](https://docs.marketcheck.com/docs/api/cars/vehicle-specs/available-options)

---



### 4. API Webhook Setup

**Description:**

- Launched a self-service webhook configuration interface in the Marketcheck Universe Portal.
- Allows clients to configure, manage, and monitor webhook endpoints for real-time API and data feed updates.
- Improves event-driven integrations and near real-time data consumption.
- Documentation: [[Webhook Setup Documentation]](https://docs.marketcheck.com/docs/get-started/api/webhook-integration)

---



### 5. API Usage Quota Alerts Setup

**Description:**

- Introduced configurable API usage quota alerts in the Marketcheck Universe Portal.
- Enables clients to monitor usage, set custom alert thresholds, and receive email notifications.
- Helps prevent unexpected quota overruns and improves usage transparency.
- Documentation: [[API Usage Alerts Documentation]](https://docs.marketcheck.com/docs/get-started/api/quota-and-rate-limits#api-monitoring)



## Optimizations



### 6. Rate Limit Enhancement for Standard Subscription

**Description:**

- Increased pagination rate limits for Standard subscription plans from 20 to 40 requests per second.
- Improves performance and throughput for higher-volume pagination use cases.

---



### 7. MSA-Level Search Support (Dealer & Dealership APIs)

**Description:**

- Added support for `msa_code` filtering in Dealer and Dealership Search APIs.
- Enables metro-area–level filtering for improved geographic targeting and analytics use cases.

---



### 8. Incentives API – Photo Links Parameter

**Description:**

- Added the `photo_links` parameter to the Incentives API.
- Allows retrieval of incentive listings that include associated vehicle images.
- Enhances data richness and downstream presentation use cases.

---



### 9. UK APIs – New Compliance Fields

**Description:**

- Added new response fields to UK-based endpoints:
- `fca_status`
- `fca_reference_number`
- `is_ulez_compliant`
- Improves regulatory compliance visibility and accuracy of UK vehicle data.

---



### 10. FSBO & Auction Inventory Filtering Enhancements

**Description:**

- Enhanced FSBO and Auction inventory APIs to support filtering by `source` and `dealer_id`.
- Added facet and stats support on dealer and source fields.
- Enables more precise and targeted inventory discovery.

---



### 11. Dealership Inventory Syndication – Row Limit Enforcement

**Description:**

- Enforced row limits on the Dealership Inventory Syndication API.
- Free plan requests are limited to 10 listings per response.
- Improves platform stability and ensures controlled data access.

---



### 12. UK Search API – Dealer Name Filtering

**Description:**

- Enabled `dealer_name` filtering in UK Search APIs.
- Allows clients to refine search results by seller name for more relevant inventory queries.

---



### 13. Status Code–Based API Billing

**Description:**

- Enhanced billing logic to charge API usage only for successful or meaningful responses.
- Requests returning error or throttling status codes (400, 401, 403, 404, 405, 422, 429, 500) are excluded from billing.
- Improves billing transparency and reduces disputes.

---



### 14. Comprehensive API Documentation Updates

**Description:**

- Updated and corrected API documentation across US and UK History and Listings APIs.
- Ensures documentation accurately reflects current fields, data structures, and behavior.
- Reduces integration errors and ongoing support overhead.



## Other changes



### Deprecation of Legacy Request Parameters and Response Fields

**Description:**

- Deprecated multiple unused request parameters and response fields across Marketcheck Search, Inventory, and MDS APIs.
- These changes are intended to streamline API responses, improve consistency, and reduce reliance on legacy attributes.
- Deprecation warnings may be included in API responses to encourage early migration.

**Deprecation Effective Date:** 26 Nov 2025

---



#### Deprecated Request Parameters

- `lease_term`
- `trim_r`
- `lease_down_payment`
- `lease_emp`
- `finance_down_payment`
- `finance_down_payment_per`
- `finance_emp`
- `availability_status`

---



#### Deprecated Response Fields

- `model_code` – appears in listing response objects
- `loan_term` – appears in `financing_options`
- `loan_apr` – appears in `financing_options`
- `listing_type` – appears in listing response objects

---



#### Affected Endpoints

- `/v2/search/car/active`
- `/v2/search/car/fsbo/active`
- `/v2/search/car/auction/active`
- `/v2/search/car/recents`
- `/v2/search/car/uk/recents`
- `/v2/car/dealer/inventory/active`
- `/v2/mds/car`
- `/v2/search/rv/uk/active` (availability_status only)

---



### Sunset Timeline and Client Impact

**Description:**

- Deprecated parameters and fields are scheduled to be fully removed after the sunset date.
- Continued usage beyond the sunset date may result in ignored fields or breaking changes.
- Early migration is strongly recommended to ensure uninterrupted compatibility with current and future Marketcheck API releases.

**Sunset Effective Date:** 10 Aug 2026



## Bug fixes



### 15. Dealerships API – Error Handling Improvements

**Description:**

- Improved error handling in the Dealerships API by standardizing responses for invalid or incorrect request parameters.
- Provides clearer, more consistent error messages for client integrations.
- Affected Endpoint: `/v2/dealerships/car`
