# Kelley Blue Book IDWS 4.0 Vehicle Service

**Canonical:** https://apis.io/apis/cox-automotive/kbb-idws-vehicle/  
**Provider:** Cox Automotive — https://apis.io/providers/cox-automotive/  
**Base URL:** https://idws.datasolutions.coxautoinc.com  
**Documentation:** https://developer.kbb.com/idws/1-Default

Kelley Blue Book IDWS 4.0 Vehicle Service 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 Data, Vehicle Valuations, VIN Decoding, and Automotive. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

InfoDriver Web Service (IDWS) 4.0 Vehicle Service — a RESTful Kelley Blue Book API returning vehicle configuration, makes, models, model years, trims, body styles, options, specifications, typicals, CPO programs, cost-to-own and Blue Book values, plus VIN lookup. API-key authenticated through the Cox Automotive Mashery gateway.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| POST | `/idws/vehicle/applyconfiguration` | Takes a collection of ConfigurationChanges and applies them to a specified vehicle configuration |
| GET | `/idws/vehicle/bodystyles` | Gets a list of Body Styles |
| POST | `/idws/vehicle/costtoown` | Provides 5 Year Cost To Own Vehicle Information. |
| GET | `/idws/vehicle/cpoprograms` | Get CPO Program Details. |
| GET | `/idws/vehicle/errorcodes` | Gets a list of error codes for IDWS Vehicle referencing from VRS |
| GET | `/idws/vehicle/links/id/{vehicleId}` | Gets a link to a vehicle on kbb.com |
| GET | `/idws/vehicle/makes/id/{makeId}` | Gets a single make |
| GET | `/idws/vehicle/makes` | Gets a list of makes |
| GET | `/idws/vehicle/marketingcategories` | Gets a list of Marketing Categories |
| GET | `/idws/vehicle/models` | Gets a list of models |
| GET | `/idws/vehicle/models/id/{modelId}` | Gets a model |
| GET | `/idws/vehicle/modelyears` | Gets a list of model years |
| GET | `/idws/vehicle/modelyears/id/{id}` | Get the Model Year based on ID |
| GET | `/idws/vehicle/specifications` | — |
| GET | `/idws/vehicle/trims/id/{trimId}` | Gets a single trim |
| GET | `/idws/vehicle/trims` | Gets a list of trims |
| GET | `/idws/vehicle/typicals` | Gets Typical Mileage List of a Vehicle |
| POST | `/idws/vehicle/validateconfiguration` | Examines a collection of VehicleOptions to determine if they are a valid configuration for the given vehicleId |
| POST | `/idws/vehicle/values` | — |
| GET | `/idws/vehicle/vehicles` | Gets a list of vehicles |
| GET | `/idws/vehicle/vehicles/id/{id}` | Get the vehicle based on ID |
| GET | `/idws/vehicle/vehicleoptions` | Gets a list of vehicle options |
| GET | `/idws/vehicle/vehiclespecs` | Gets a list of Vehicle Specifications. |
| GET | `/idws/vehicle/vin/id/{vin}` | Returns a list of vehicles matching a given VIN. |
| GET | `/idws/vehicle/years` | Gets a list of years |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/openapi/cox-automotive-kbb-idws-vehicle-openapi.yml
- **Documentation** — https://developer.kbb.com/idws/1-Default
- **APIReference** — https://developer.kbb.com/idws/99-Swagger
- **Postman** — https://god.gw.postman.com/run-collection/1195870-3ff750f7-69e7-49e2-bbaa-e42fecb49939
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/overlays/cox-automotive-kbb-idws-vehicle-overlay.yaml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/cox-automotive/refs/heads/main/apis.yml

## Other Cox Automotive APIs (7)

- [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 Instant Cash Offer (ICO) API](https://apis.io/apis/cox-automotive/kbb-instant-cash-offer/)
- [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 Data, Vehicle Valuations, VIN Decoding, Automotive

---

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