# Kelley Blue Book Instant Cash Offer (ICO) API

**Canonical:** https://apis.io/apis/cox-automotive/kbb-instant-cash-offer/  
**Provider:** Cox Automotive — https://apis.io/providers/cox-automotive/  
**Base URL:** https://api.kbb.com/ico/v1  
**Documentation:** https://developer.kbb.com/ico/1-Default

Kelley Blue Book Instant Cash Offer (ICO) API is one of 8 APIs that [Cox Automotive](https://apis.io/providers/cox-automotive/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Vehicle Valuations, Automotive Retail, Trade-In, and Automotive. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Produces a Kelley Blue Book Instant Cash Offer for a vehicle. Vehicle configuration lookups (year, make, model, trim, transmission, engine, drivetrain, colour, options), licence-plate-to-VIN lookup, prospect creation with history, condition and contact information, and offer creation and retrieval. Responses use a meta/data envelope with numeric Cox Automotive result codes.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/vehicles/vin/{vin}` | — |
| GET | `/vehicles/years` | — |
| OPTIONS | `/vehicles/years` | — |
| GET | `/vehicles/makes` | — |
| OPTIONS | `/vehicles/makes` | — |
| GET | `/vehicles/models` | — |
| OPTIONS | `/vehicles/models` | — |
| GET | `/vehicles/trims` | — |
| OPTIONS | `/vehicles/trims` | — |
| GET | `/vehicles/colors` | — |
| OPTIONS | `/vehicles/colors` | — |
| GET | `/vehicles/transmissions` | — |
| OPTIONS | `/vehicles/transmissions` | — |
| GET | `/vehicles/engines` | — |
| OPTIONS | `/vehicles/engines` | — |
| GET | `/vehicles/drivetrains` | — |
| OPTIONS | `/vehicles/drivetrains` | — |
| GET | `/vehicles/options` | — |
| OPTIONS | `/vehicles/options` | — |
| GET | `/vehicles/eligibility` | — |
| OPTIONS | `/vehicles/eligibility` | — |
| GET | `/plate2vin/lookup` | — |
| GET | `/plate2vin/states` | — |
| POST | `/prospects` | — |
| OPTIONS | `/prospects` | — |
| GET | `/prospects/{prospectId}` | — |
| OPTIONS | `/prospects/{prospectId}` | — |
| GET | `/prospects/{prospectId}/history` | — |
| PATCH | `/prospects/{prospectId}/history` | — |
| OPTIONS | `/prospects/{prospectId}/history` | — |
| PATCH | `/prospects/{prospectId}/options` | — |
| OPTIONS | `/prospects/{prospectId}/options` | — |
| GET | `/prospects/{prospectId}/conditions` | — |
| PATCH | `/prospects/{prospectId}/conditions` | — |
| OPTIONS | `/prospects/{prospectId}/conditions` | — |
| GET | `/prospects/{prospectId}/contactInfo` | — |
| PATCH | `/prospects/{prospectId}/contactInfo` | — |
| OPTIONS | `/prospects/{prospectId}/contactInfo` | — |
| POST | `/offers` | — |
| OPTIONS | `/offers` | — |
| GET | `/offers/{offerId}` | — |
| OPTIONS | `/offers/{offerId}` | — |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/openapi/cox-automotive-kbb-instant-cash-offer-openapi.yml
- **Documentation** — https://developer.kbb.com/ico/1-Default
- **APIReference** — https://developer.kbb.com/ico/99-Swagger
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/errors/cox-automotive-error-codes.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/overlays/cox-automotive-kbb-instant-cash-offer-overlay.yaml

## Other Cox Automotive APIs (7)

- [Kelley Blue Book IDWS 4.0 Vehicle Service](https://apis.io/apis/cox-automotive/kbb-idws-vehicle/)
- [Kelley Blue Book IDWS 4.0 Editorial Service](https://apis.io/apis/cox-automotive/kbb-idws-editorial/)
- [Kelley Blue Book Advertising Data API](https://apis.io/apis/cox-automotive/kbb-advertising-data/)
- [Kelley Blue Book Batch VIN API](https://apis.io/apis/cox-automotive/kbb-batch-vin/)
- [Manheim Hypermedia API Suite](https://apis.io/apis/cox-automotive/manheim/)
- [Manheim Event Notifications](https://apis.io/apis/cox-automotive/manheim-events/)
- [Cox Automotive Integration Platform (API Storefront)](https://apis.io/apis/cox-automotive/integration-platform/)

## Tags

Vehicle Valuations, Automotive Retail, Trade-In, Automotive

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cox-automotive/kbb-instant-cash-offer/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cox-automotive/.