# API Release - v4.0.0

> New incentive endpoints, a Dealerships endpoint for the US and UK, the mc_dealership object in listing responses, UK listing redirection parameters, and NeoVIN option build rules.



## New features

1. **New Incentive Endpoint**
2. **Description:** Two new endpoints replace the existing incentive search API and allow zip code-based searches, leveraging MSA codes for improved accuracy and efficiency.
3. **Updated Endpoint:** /v2/search/car/incentives/oem
4. **New Endpoint:** /v2/search/car/incentives/{oem}/{zip}
5. **Pricing:** $20 per 100 requests
6. **Documentation**
7. [[ Updated Incentive Endpoint ]](https://apidocs.marketcheck.com/#0b794e99-4025-420f-b7bd-4585f374f8a8)
8. [[ New Incentive Endpoint ]](https://apidocs.marketcheck.com/#e9b4ff9b-e176-4ac0-a9b5-518acd1de0cb)
9. **Migration guide -** Since this is a breaking change, please refer to the migration guide → [[ Migration guide ]](https://marketcheck.atlassian.net/wiki/spaces/MAR/pages/3264643088)
10. **Key Improvements:**
11. Reduced redundancy through MSA-level crawl data.
12. Enhanced LLM-based data extraction for better accuracy.
13. Simplified ingestion with a deduplicated schema.
14. **Example Requests:**
15. `https://mc-api.marketcheck.com/v2/search/car/incentives/oem?api_key={api_key}&make=Ford`
16. `https://mc-api.marketcheck.com/v2/search/car/incentives/mini/90001?api_key={api_key}`
17. **Dealerships Endpoint**
18. **Description:** This endpoint provides detailed dealership information for the US and UK.
19. **Endpoints:**
20. US: /v2/dealerships/car
21. UK: /v2/dealerships/car/uk
22. **Pricing:** $0.25 per 100 requests (same as Dealer API).
23. **Documentation**
24. [[ Dealership APIs ]](https://apidocs.marketcheck.com/#cec1f011-367e-4779-9591-0a6deb889609)
25. [[ UK Dealership APIs ]](https://apidocs.marketcheck.uk/#1ade4d60-12d0-413e-9c55-144224d8eede)
26. **Example Requests:**
27. `https://mc-api.marketcheck.com/v2/dealerships/car?api_key={api_key}`
28. `https://mc-api.marketcheck.com/v2/dealerships/car/uk?api_key={api_key}`
29. **Enhanced Listing Response**
30. **Description:** Dealership fields are now integrated into the **Dealer Active Inventory API**. A new mc_dealership object has been introduced for comprehensive dealership information in API response.
31. **Endpoints:**
32. /v2/search/car/active
33. /v2/search/car/uk/active
34. /v2/search/car/recents
35. /v2/search/car/uk/recents
36. /v2/car/dealer/inventory/active
37. /v2/listing/car/{id}
38. /v2/listing/car/uk/{id}
39. **Example Requests:**
40. `https://mc-api.marketcheck.com/v2/search/car/active?api_key={api_key}`
41. `https://mc-api.marketcheck.com/v2/car/dealer/inventory/active?api_key={api_key}&mc_website_id=1038994`
42. **UK Listing API Redirection**
43. **Description:** New parameters, redirect_to_active and redirect_to_latest, ensure users are always directed to active or the latest car listings.
44. redirect_to_active: Redirects users to the active listing if the current listing is inactive.
45. redirect_to_latest: Redirects users to the latest listing if the current listing is inactive.
46. When both redirect_to_active=true and redirect_to_latest=true are set, the redirect_to_active condition takes precedence.
47. **Endpoints:**
48. /v2/listing/car/uk/{id}
49. **Example Requests:**
50. `https://mc-api.marketcheck.com/v2/listing/car/uk/{id}?api_key={api_key}&redirect_to_active=true`
51. `https://mc-api.marketcheck.com/v2/listing/car/uk/{id}?api_key={api_key}&redirect_to_latest=true`



## Optimizations

1. Neovin API Update
2. **Description:** The Neovin API now supports option build rules for improved MSRP calculations and accurate vehicle option identification.
3. **Endpoint:** /v2/decode/car/neovin/{vin}/specs
4. **Example Request:** `https://mc-api.marketcheck.com/v2/decode/car/neovin/{vin}/specs?api_key={api_key}`