API
Sign Up

Vehicle specification API: factory equipment and optional extras

Last updated: 9 November 2026

POST a registration or VIN to /api/v1/vehicle/spec and you get the manufacturer specification for the model: every item of standard equipment, and the optional extras the manufacturer offered for it, each with its category, name, fitment (Standard, Option or Free) and price where it has one. It costs 22p a call on Pay As You Go, down to 15p on Enterprise. Sandbox keys are free and answer for the published test registrations (GET /v1/sandbox/vrms, no key needed), so you can build the whole integration before paying for a call.

The specification describes the model as built by the factory. It does not say which optional extras this particular car was built with.

For engine, power, dimensions, weights and fuel consumption, use the decode endpoint, which carries those figures for the vehicle.

Get a free sandbox keyTry it in the test consoleAll prices

Prices per call

Prices in force today, per call, by package. Errors are not charged except where the API reference says so. Live keys only: sandbox calls are free.

EndpointPay As You GoStarterProEnterprise
Specification
POST /api/v1/vehicle/spec
The factory standard equipment for the model and the optional extras offered for it, with prices.
Daily cap per account: 300 / 1,000 / 3,000 / 10,000
22p20p18p15p
Vehicle decode
POST /api/v1/vehicle/decode
Engine, power, dimensions, weights and the registration record.
Daily cap per account: 300 / 1,000 / 3,000 / 10,000
16p10p8p6p

Pay As You Go has no monthly fee (top up from £10). On Starter, Pro, Enterprise the monthly fee comes back as plan credit to spend on calls, expiring at the end of each monthly billing period. Package limits per second, minute and day are on the pricing page.

Example request and answer

Every endpoint is a JSON POST under https://www.dealerpricing.co.uk/api with your key in the X-API-Key header. This request uses a sandbox test value, so it is free with a sandbox key.

curl -X POST https://www.dealerpricing.co.uk/api/v1/vehicle/spec \
  -H "X-API-Key: your_sandbox_key" \
  -H "Content-Type: application/json" \
  -d '{"vrm":"SA22TLZ"}'

The answer (long lists shortened; fields not held for a vehicle are left out):

{
  "success": true,
  "data": {
    "specification": {
      "vrm": "SA22TLZ",
      "vehicle": {
        "make": "Volkswagen",
        "model": "Polo Life TSi",
        "model_description": "Polo Life TSi",
        "year": 2022
      },
      "factory_equipment": {
        "count": 64,
        "items": [
          {
            "category": "Audio and Communications",
            "name": "Satellite Navigation",
            "description": "Discover Navigation Pro",
            "fitment": "Option",
            "type": "Item",
            "price": 1415
          },
          {
            "category": "Audio and Communications",
            "name": "Satellite Navigation",
            "description": "Discovr Navigation System",
            "fitment": "Option",
            "type": "Item",
            "price": 570
          }
        ]
      },
      "raw": {}
    }
  },
  "meta": {
    "request_id": "req_3f9a1c0d2b7e4a5f6c8d9e01",
    "cost_pence": 22,
    "balance_pence": 978,
    "is_sandbox": false
  }
}

What you get

specification.vehicle.make
Make, model, model_description and year
specification.factory_equipment.count
How many equipment items are listed
specification.factory_equipment.items[].category
Category of each item (for example audio, safety, wheels)
specification.factory_equipment.items[].name
Name and description of each item
specification.factory_equipment.items[].fitment
Standard, Option or Free
specification.factory_equipment.items[].price
List price of an optional extra, where it has one

Every field, with its type and meaning, is in the API reference.

What developers use it for

  • Write fuller advert descriptions from the standard equipment list.
  • Show buyers what the model came with as standard.
  • Compare trims of the same model.

Questions

What does the vehicle specification API return?

The factory standard equipment for the model and the optional extras the manufacturer offered for it, each with a category, name, fitment (Standard, Option or Free) and, for extras, the price.

Does it tell me which options this car has?

No. It lists what was standard and what was offered as an option for the model. It does not say which optional extras this particular car was built with.

How much does a specification call cost?

Pay As You Go 22p, Starter 20p, Pro 18p, Enterprise 15p. A vehicle that is not found is not charged.

Can I send a VIN?

Yes. Send vrm or vin. When both are sent, the VIN is used.

Where do I get engine size, power and dimensions?

From the decode endpoint, /api/v1/vehicle/decode, for 16p a call on Pay As You Go.

Documentation and next steps