# Vehicle Specifications API

> Get detailed vehicle specifications by VIN, including year, make, model, engine, and more.

Specifications returns the factory technical data for a vehicle by VIN: base MSRP and invoice, seating, available colors, engine, fuel economy, measurements such as wheelbase and curb weight, and standard features. Send GET /specs/{vin} with your API key. It is available from the Growth plan at $0.0015 per call, or $0.001 on Scale.

## Endpoint

`GET https://api.auto.dev/specs/{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/specs/WP0AF2A99KS165242" \
  -H "Authorization: Bearer $AUTODEV_API_KEY"
```

## What it returns

- Style name
- Base MSRP and invoice
- Seating
- Exterior and interior colors
- Engine and fuel economy
- Measurements

Response:

```json
{
  "vehicle": {
    "vin": "WP0AF2A99KS165242",
    "year": 2019,
    "make": "Porsche",
    "model": "911",
    "manufacturer": "Dr Ing HCF Porsch Ag"
  },
  "specs": {
    "name": "GT3 RS 2dr Coupe (4.0L 6cyl 7AM)",
    "price": {
      "baseMsrp": 187500,
      "baseInvoice": 168750
    },
    "totalSeating": 2,
    "color": {
      "exterior": [
        {
          "name": "Lizard Green",
          "rgb": "87,178,44"
        },
        {
          "name": "Miami Blue",
          "rgb": "3,161,192"
        },
        {
          "name": "Racing Yellow",
          "rgb": "229,200,38"
        },
        {
          "name": "Guards Red",
          "rgb": "175,26,28"
        }
      ],
      "interior": [
        {
          "name": "Black, leather/sueded microfiber",
          "rgb": "0,0,0"
        },
        {
          "name": "Black/Lizard Green, leather/sueded microfiber",
          "rgb": "0,0,0"
        }
      ]
    },
    "features": {
      "engine": {
        "torque": "346 lb-ft @ 6000 rpm",
        "baseEngineSize": "4.0 L",
        "horsepower": "520 hp @ 8250 rpm",
        "valves": "24",
        "baseEngineType": "gas",
        "directInjection": true,
        "valveTiming": "Variable",
        "cylinders": "flat 6",
        "camType": "Double overhead cam (DOHC)"
      },
      "fuel": {
        "epaCombinedMpg": "16 MPG",
        "epaCity/highwayMpg": "15/19 MPG",
        "rangeInMiles (city/hwy)": "253.5/321.1 mi.",
        "fuelTankCapacity": "16.9 gal.",
        "fuelType": "premium unleaded (required)"
      },
      "measurements": {
        "maximumCargoCapacity": "4.4 cu.ft.",
        "countryOfFinalAssembly": "Germany",
        "wheelbase": "96.6 in.",
        "curbWeight": "3153 lbs.",
        "grossWeight": "3953 lbs.",
        "cargoCapacity,AllSeatsInPlace": "4.4 cu.ft.",
        "maximumPayload": "800 lbs.",
        "overallWidthWithMirrors": "77.9 in.",
        "length": "179.4 in.",
        "manufacturer060MphAccelerationTime": "3.0 seconds",
        "turningCircle": "36.4 ft.",
        "height": "51.1 in.",
        "overallWidthWithoutMirrors": "74.0 in."
      },
      "driveTrain": {
        "driveType": "rear wheel drive",
        "rearLockingDifferential": true,
        "rearLimitedSlipDifferential": true,
        "transmission": "7-speed automated manual"
      },
      "warranty": {
        "basic": "4 yr./ 50000 mi.",
        "drivetrain": "4 yr./ 50000 mi.",
        "freeMaintenance": "1 yr./ 10000 mi.",
        "rust": "12 yr./ unlimited mi.",
        "roadsideAssistance": "4 yr./ 50000 mi."
      },
      "safety": {
        "4WheelAbs": true,
        "daytimeRunningLights": true,
        "engineImmobilizer": true,
        "postCollisionSafetySystem": true,
        "frontHeadAirbags": true,
        "dualFrontSideMountedAirbags": true,
        "passengerAirbagOccupantSensingDeactivation": true,
        "stabilityControl": true,
        "tirePressureMonitoring": true,
        "tractionControl": true
      },
      "frontseats": {
        "heightAdjustablePassengerSeat": true,
        "heightAdjustableDriverSeat": true,
        "sportFrontSeats": true,
        "2WayPowerPassengerSeat": true,
        "leather/suededMicrofiber": true,
        "2WayPowerDriverSeat": true
      }
    },
    "orderedFeatures": [
      {
        "category": "Fuel",
        "categoryGroup": "Mechanical",
        "features": {
          "fuelType": "Premium unleaded (required)",
          "epaCity/highwayMpg": "15/19 MPG",
          "epaCombinedMpg": "16 MPG",
          "rangeInMiles (city/hwy)": "253.5/321.1 mi.",
          "fuelTankCapacity": "16.9 gal."
        }
      },
      {
        "category": "Engine",
        "categoryGroup": "Mechanical",
        "features": {
          "baseEngineSize": "4.0 L",
          "cylinders": "Flat 6",
          "baseEngineType": "Gas",
          "horsepower": "520 hp @ 8250 rpm",
          "torque": "346 lb-ft @ 6000 rpm",
          "valves": "24",
          "camType": "Double overhead cam (DOHC)",
          "valveTiming": "Variable",
          "directInjection": true
        }
      }
    ],
    "typeCategories": {
      "performancesports": {
        "id": 10,
        "name": "Performance/Sports"
      },
      "coupe": {
        "id": 2,
        "name": "Coupe"
      },
      "luxury": {
        "id": 8,
        "name": "Luxury"
      }
    },
    "styleAttributes": {
      "electric": false,
      "pluginElectric": false,
      "truck": false
    }
  }
}
```

## Pricing

- Free: not available on this plan, 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_specs` MCP tool. From the terminal: `auto specs WP0AF2A99KS165242`

## Questions

### What does the Specifications API return?

Style name, base MSRP and invoice, seating, exterior and interior colors, engine and fuel economy, measurements. Every response is JSON from `https://api.auto.dev/specs/{vin}`.

### How much does the Specifications API cost?

Specifications is available from the Growth plan. 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 Specifications API?

Send `GET /specs/{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 Specifications?

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

### Can AI agents use the Specifications 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_specs` 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

- [Global VIN Decode](https://www.auto.dev/vin.md): Decode any VIN to access comprehensive vehicle data and specifications.
- [Plate-to-VIN](https://www.auto.dev/plate-to-vin.md): Decode US license plates to get VIN, year, make, model, and more.
- [OEM Build Data](https://www.auto.dev/oem-build-data.md): Original equipment manufacturer build data and production information.

## References

- Docs: https://docs.auto.dev/v2/products/specifications
- 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