# Vehicle Listings API

> Get comprehensive vehicle listings from U.S. physical & online dealers in seconds.

Vehicle Listings returns active U.S. dealer listings from physical and online dealers, with the vehicle, price, new or used status, dealer, location, Carfax link and photos. Send GET /listings/{vin} for one car, or search with query parameters. It is included on the Free plan, then costs $0.0015 per call on Growth and $0.001 on Scale.

## Endpoint

`GET https://api.auto.dev/listings/{vin}`

- `vin` (path): 17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q). Format: `[A-HJ-NPR-Z0-9]{17}`.

Authenticate with `Authorization: Bearer <key>`, `?apiKey=<key>` or `X-API-Key: <key>`.

```sh
curl "https://api.auto.dev/listings/10ARJYBS7RC154562" \
  -H "Authorization: Bearer $AUTODEV_API_KEY"
```

## What it returns

- Vehicle details
- Retail price
- New, used or certified
- Dealer and location
- Listing page and Carfax link
- Primary photo

Response:

```json
{
  "data": {
    "@id": "https://api.auto.dev/listings/10ARJYBS7RC154562",
    "vin": "10ARJYBS7RC154562",
    "location": [-77.0334, 40.2476],
    "online": true,
    "vehicle": {
      "vin": "10ARJYBS7RC154562",
      "squishVin": "10ARJYBSRC",
      "year": 2024,
      "make": "Jeep",
      "model": "Grand Cherokee",
      "trim": "4xe",
      "drivetrain": "4WD",
      "engine": "Plug-In Hybrid",
      "fuel": "Plug-In Hybrid",
      "transmission": "Automatic",
      "confidence": 0.005,
      "doors": 4,
      "seats": 5
    },
    "wholesaleListing": null,
    "retailListing": {
      "vdp": "http://details.vast.com/details/cars/ob-48ae10cec45c5264c0c05239af7ac2c3eda678223f9171ac63be6a3107cd3db63b027b96ef83ac88fd6ccb42933d4f3c6bf26f82a637df6dbf6160746a741de2e12135dcbeff82654b855069fa243842784cfba33bf3b93b6d5a9156baa8b0f948d0b715b4936664c48f9fdb248501ca1a015077c28df814c6ae254e205e6b8afb7f16011f22412ebedeee38685f0721f74c31246e538ff42db94d2ceb09e6950fb15e40f90d9a2a0fa486f173a58cc4/?pl=19",
      "price": 0,
      "used": false,
      "cpo": false,
      "carfaxUrl": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=10ARJYBS7RC154562&partner=FRD_2",
      "dealer": "Faulkner Dodge Ram Mechanicsburg New",
      "city": "Mechanicsburg",
      "state": "PA",
      "zip": "17050",
      "primaryImage": "https://retail.photos.vin/10ARJYBS7RC154562-1.jpg",
      "photoCount": 1
    },
    "history": null
  }
}
```

## Pricing

- Free: included (1,000 calls a month, capped), 5 requests per second
- Growth: $0.0015 per call, 10 requests per second
- Scale: $0.001 per call, 50 requests per second

## Use it from an AI agent

Hosted MCP server (recommended): https://mcp.auto.dev/mcp, named `auto-dev`. Sign-in is OAuth on first use, so agents never handle an API key.

- Claude Code: `claude mcp add --transport http auto-dev https://mcp.auto.dev/mcp`. Then run /mcp in Claude Code and choose Authenticate for auto-dev.
- Claude Desktop: In Settings, open Connectors, choose Add Custom Connector, name it auto-dev and paste https://mcp.auto.dev/mcp, then sign in
- Cursor (~/.cursor/mcp.json): `{"mcpServers":{"auto-dev":{"url":"https://mcp.auto.dev/mcp"}}}`. Restart Cursor. Sign-in opens on the first tool call.
- VS Code (.vscode/mcp.json): `{"servers":{"auto-dev":{"type":"http","url":"https://mcp.auto.dev/mcp"}}}`. For Copilot agent mode, VS Code 1.99 or later. Sign-in opens on first use.
- Windsurf (~/.codeium/windsurf/mcp_config.json): `{"mcpServers":{"auto-dev":{"serverUrl":"https://mcp.auto.dev/mcp"}}}`. Restart Windsurf. Sign-in opens on the first tool call.
- Grok Bot: send `Add a custom MCP server called auto-dev at https://mcp.auto.dev/mcp`. Confirm, then choose Authorize and sign in. Type @auto-dev in a chat to use it.
- Muse: send `Connect Auto.dev`. Or open Settings, then Connectors, and choose Connect next to Auto.dev. Sign in when asked.
- ChatGPT and dots: At chatgpt.com/plugins, choose + and Add custom MCP server, paste https://mcp.auto.dev/mcp and choose OAuth, then Create as a plugin. Your dot uses the same plugin

Or install the `auto` CLI, the local MCP server (`auto --mcp`) and the JavaScript SDK in one package:

```sh
npm install -g @auto.dev/sdk
auto login
auto mcp install
```

- Agent skill: `npx skills add drivly/auto-dev-skill`

This API is the `auto_listings` MCP tool. From the terminal: `auto listings --make Jeep --model "Grand Cherokee"`

## Questions

### What does the Vehicle Listings API return?

Vehicle details, retail price, new, used or certified, dealer and location, listing page and Carfax link, primary photo. Every response is JSON from `https://api.auto.dev/listings/{vin}`.

### How much does the Vehicle Listings API cost?

Vehicle Listings is included on the Free plan, which has 1,000 API calls a month and no card required. On paid plans it costs $0.0015 per call on Growth and $0.001 per call on Scale, on top of the plan's subscription.

### How do I call the Vehicle Listings API?

Send `GET /listings/{vin}` to `api.auto.dev` with your API key as a Bearer token in the `Authorization` header, or as an `apiKey` query parameter. The path takes `vin`, the 17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q).

### What are the rate limits for Vehicle Listings?

Rate limits follow your plan: 5 requests per second on Free, 10 on Growth and 50 on Scale.

### Can AI agents use the Vehicle Listings API?

Yes. Connect the hosted MCP server, `https://mcp.auto.dev/mcp`, and agents such as Claude Code and Cursor call it as the `auto_listings` tool, signing in with OAuth instead of an API key. Or run it locally: `npm install -g @auto.dev/sdk`, then `auto login` and `auto mcp install`.

## Related APIs

- [Vehicle Photos](https://www.auto.dev/vehicle-photos.md): High-quality vehicle images and photo galleries for listings and inventory.

## References

- Docs: https://docs.auto.dev/v2/products/vehicle-listings
- OpenAPI: https://www.auto.dev/openapi.json (JSON), https://www.auto.dev/openapi.yaml (YAML)
- llms.txt: https://www.auto.dev/llms.txt
- Pricing: https://www.auto.dev/pricing
- Sign up: https://www.auto.dev/signin?redirectUrl=%2Fonboarding