# MotorsDynamic API documentation

Vehicle data read straight from dealer websites: listings, price history, OEM incentives and market prices, over one REST API and one MCP server.

Base URL: `https://api.motorsdynamic.com/api/v2`. Send your key as `x-api-key`. The whole API as one OpenAPI 3.1 document: https://developers.motorsdynamic.com/openapi.json

## Get started

- [Quickstart](https://developers.motorsdynamic.com/docs/quickstart.md): From no account to a live response in about a minute.
- [Authentication](https://developers.motorsdynamic.com/docs/authentication.md): One key, three ways to send it.
- [Plans and rate limits](https://developers.motorsdynamic.com/docs/rate-limits.md): What each plan includes and how limits are reported.
- [Errors](https://developers.motorsdynamic.com/docs/errors.md): One error shape, a short list of codes.

## APIs

- [VIN decode](https://developers.motorsdynamic.com/docs/decode-vin.md): `GET /vin/{vin}`. Free and up.
- [Listings for a VIN](https://developers.motorsdynamic.com/docs/vin-listings.md): `GET /listings/{vin}`. Free and up.
- [Photos](https://developers.motorsdynamic.com/docs/vin-photos.md): `GET /photos/{vin}`. Free and up.
- [Specifications](https://developers.motorsdynamic.com/docs/vin-specs.md): `GET /specs/{vin}`. Free and up.
- [Listing and price history](https://developers.motorsdynamic.com/docs/vin-history.md): `GET /history/{vin}`. Free and up.
- [Vehicle history](https://developers.motorsdynamic.com/docs/vehicle-timeline.md): `GET /vehicles/{vin}/timeline`. Free and up.
- [Fuel economy](https://developers.motorsdynamic.com/docs/vin-fuel.md): `GET /fuel/{vin}`. Free and up.
- [Owner complaints](https://developers.motorsdynamic.com/docs/vin-complaints.md): `GET /complaints/{vin}`. Free and up.
- [Recalls](https://developers.motorsdynamic.com/docs/vin-recalls.md): `GET /recalls/{vin}`. Free and up.
- [Safety ratings](https://developers.motorsdynamic.com/docs/vin-safety.md): `GET /safety/{vin}`. Free and up.
- [Market prices](https://developers.motorsdynamic.com/docs/market-prices.md): `GET /market/prices`. Growth and up.
- [OEM incentives](https://developers.motorsdynamic.com/docs/offers.md): `GET /offers`. Growth and up.
- [Window sticker](https://developers.motorsdynamic.com/docs/vin-build.md): `GET /build/{vin}`. Growth and up.
- [Interest rates](https://developers.motorsdynamic.com/docs/vin-apr.md): `GET /apr/{vin}`. Growth and up.
- [Payments](https://developers.motorsdynamic.com/docs/vin-payments.md): `GET /payments/{vin}`. Growth and up.
- [Taxes and fees](https://developers.motorsdynamic.com/docs/vin-taxes.md): `GET /taxes/{vin}`. Growth and up.
- [Total cost of ownership](https://developers.motorsdynamic.com/docs/vin-tco.md): `GET /tco/{vin}`. Growth and up.
- [Open recalls](https://developers.motorsdynamic.com/docs/vin-open-recalls.md): `GET /openrecalls/{vin}`. Scale and up.

## Enterprise APIs

Market search, full dealer inventory, change feeds and specials.

- [Collection runs](https://developers.motorsdynamic.com/docs/runs.md): `GET /runs`. Enterprise.
- [Dealer inventory](https://developers.motorsdynamic.com/docs/inventory.md): `GET /dealers/{domainId}/inventory`. Enterprise.
- [Dealer specials](https://developers.motorsdynamic.com/docs/specials.md): `GET /specials`. Enterprise.
- [Dealers](https://developers.motorsdynamic.com/docs/dealers.md): `GET /dealers`. Enterprise.
- [Inventory change feed](https://developers.motorsdynamic.com/docs/changes.md): `GET /dealers/{domainId}/changes`. Enterprise.
- [New units and in-transit](https://developers.motorsdynamic.com/docs/new-units.md): `GET /dealers/{domainId}/new-units`. Enterprise.
- [Refresh specials](https://developers.motorsdynamic.com/docs/refresh-target.md): `POST /targets/{domainId}/refresh`. Enterprise.
- [Register a dealer](https://developers.motorsdynamic.com/docs/register-dealer.md): `POST /dealers`. Enterprise.
- [Register specials targets](https://developers.motorsdynamic.com/docs/register-targets.md): `POST /targets`. Enterprise.
- [Remove a specials target](https://developers.motorsdynamic.com/docs/delete-target.md): `DELETE /targets/{domainId}`. Enterprise.
- [Request a recrawl](https://developers.motorsdynamic.com/docs/recrawl-dealer.md): `POST /dealers/{domainId}/recrawl`. Enterprise.
- [Special history](https://developers.motorsdynamic.com/docs/special-history.md): `GET /specials/{specialId}/history`. Enterprise.
- [Specials change feed](https://developers.motorsdynamic.com/docs/specials-history.md): `GET /specials/history`. Enterprise.

## AI agents

- [MCP server](https://developers.motorsdynamic.com/docs/mcp.md): Vehicle data as tools for Claude, ChatGPT, Cursor, VS Code and Grok.
- [Claude](https://developers.motorsdynamic.com/docs/mcp/claude.md): Add MotorsDynamic as a connector in Claude on the web or desktop.
- [Claude Code](https://developers.motorsdynamic.com/docs/mcp/claude-code.md): One command, then sign in from the terminal.
- [ChatGPT](https://developers.motorsdynamic.com/docs/mcp/chatgpt.md): Add MotorsDynamic as a custom connector in ChatGPT.
- [Cursor](https://developers.motorsdynamic.com/docs/mcp/cursor.md): Add the server to your Cursor MCP config.
- [VS Code](https://developers.motorsdynamic.com/docs/mcp/vscode.md): Use the server from GitHub Copilot agent mode.
- [Grok](https://developers.motorsdynamic.com/docs/mcp/grok.md): Add MotorsDynamic as a custom connector in Grok.