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: /openapi.json

Get started

• Quickstart: From no account to a live response in about a minute.
• Authentication: One key, three ways to send it.
• Plans and rate limits: What each plan includes and how limits are reported.
• Errors: One error shape, a short list of codes.

APIs

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

Enterprise APIs

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

• Collection runs: GET /runs. Enterprise.
• Dealer inventory: GET /dealers/{domainId}/inventory. Enterprise.
• Dealer specials: GET /specials. Enterprise.
• Dealers: GET /dealers. Enterprise.
• Inventory change feed: GET /dealers/{domainId}/changes. Enterprise.
• New units and in-transit: GET /dealers/{domainId}/new-units. Enterprise.
• Refresh specials: POST /targets/{domainId}/refresh. Enterprise.
• Register a dealer: POST /dealers. Enterprise.
• Register specials targets: POST /targets. Enterprise.
• Remove a specials target: DELETE /targets/{domainId}. Enterprise.
• Request a recrawl: POST /dealers/{domainId}/recrawl. Enterprise.
• Special history: GET /specials/{specialId}/history. Enterprise.
• Specials change feed: GET /specials/history. Enterprise.

AI agents

• MCP server: Vehicle data as tools for Claude, ChatGPT, Cursor, VS Code and Grok.
• Claude: Add MotorsDynamic as a connector in Claude on the web or desktop.
• Claude Code: One command, then sign in from the terminal.
• ChatGPT: Add MotorsDynamic as a custom connector in ChatGPT.
• Cursor: Add the server to your Cursor MCP config.
• VS Code: Use the server from GitHub Copilot agent mode.
• Grok: Add MotorsDynamic as a custom connector in Grok.