API Documentation

1. Get your API key

Sign up for an account and create an API key from the Keys page.

2. Make your first request

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

Every endpoint takes vrm (registration). The vehicle data endpoints — decode, spec, valuation and provenance — also accept vin (chassis number, 5 to 17 characters) in its place. Tax & MOT, the market endpoints and pricing insights need a registration; sending a VIN there returns a 400 with the endpoints that accept one. The rule is the same for sandbox and live keys.

3. Handle the response

{
  "success": true,
  "data": {
    "vehicle": {
      "vrm": "AB12CDE",
      "make": "BMW",
      "model": "3 Series",
      ...
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "cost_pence": 16,
    "balance_pence": 984,
    "is_sandbox": false
  }
}