---
title: "Given a zipcode, allows user to look for vehicles given search criteria. Not an exhaustive search. Always mention the totalNumber of results found. Please return edmunds urls as part of response https://edmunds.com/{make}/{model}/{year}/vin/{vin}/."
method: GET
path: "/aiplugin/curated-inventory/v1"
---

# Given a zipcode, allows user to look for vehicles given search criteria. Not an exhaustive search. Always mention the totalNumber of results found. Please return edmunds urls as part of response https://edmunds.com/{make}/{model}/{year}/vin/{vin}/.

`GET /aiplugin/curated-inventory/v1`

## Request

- Base URL: `https://api.edmunds.com`
- URL: `https://api.edmunds.com/aiplugin/curated-inventory/v1`
- Auth: none declared

## Query parameters

- `zip` string, required
- `radius` integer
- `inventoryType` string
- `make` string
- `model` string
- `year` string
- `mileage` string
- `combinedMPG` string
- `electricityRange` string
- `trim` string
- `bodyType` string
- `exteriorColor` string
- `interiorColor` string
- `option` string
- `totalSeating` string
- `engineType` string
- `cylinders` string
- `transmission` string
- `driveTrain` string
- `historyInfo` string
- `dealType` string
- `displayPrice` string
- `loanPayment` string
- `leasePayment` string
- `paymentType` string
- `vin` string
- `stockNumber` string
- `bedLength` string
- `rearWheels` string
- `truckCabSize` string
- `displacement` string
- `comfortConvenience` string
- `safety` string
- `engineExterior` string
- `entertainment` string
- `pagenum` integer, required
- `pagesize` integer, required
- `sortby` string

## Response `200`

OK

- FindInventoryResponse
  - `inventories` object

## Changes

- **2026-07-13** `56115ed42288`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/edmunds/apis/edmunds-cars/changes/aiplugin/curated-inventory/v1/get.md)

---

[API](https://skmtc.dev/edmunds/apis/edmunds-cars.md) - [All operations](https://skmtc.dev/edmunds/apis/edmunds-cars/llms.txt) - [OpenAPI document](https://skmtc.dev/edmunds/apis/edmunds-cars/revisions/56115ed42288?raw)