API Documentation

Everything you need to integrate with the DealerPricing API

Quick Start

1. Get your API key

2. Make your first request

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

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
  }
}

Authentication

All API requests must include your API key in the X-API-Key header.

X-API-Key: dp_live_your_api_key_here

Sandbox Keys: Keys starting with dp_sandbox_ can only test with VRMs: SA67DVL, M123TAP, or any VRM containing the letter "A" for vehicle data endpoints.

Rate Limits

Limit	Default
Per second	5 requests
Per minute	100 requests
Per day	1,000 requests

Rate limit headers are included in every response: X-RateLimit-Remaining-*. All packages can request custom limits.

API Endpoints

Base URL: https://developer.dealerpricing.co.uk/api

Vehicle Data

POST/v1/vehicle/decode

Get comprehensive vehicle details from VRM

POST/v1/vehicle/tax-mot

Current tax status and MOT history

POST/v1/vehicle/valuation

Trade, retail, and private valuations

POST/v1/vehicle/spec

Full vehicle specifications

POST/v1/vehicle/provenance

Finance, stolen, write-off checks

Market Data

POST/v1/market/active

Similar vehicles currently for sale

POST/v1/market/sold

Similar vehicles recently sold

POST/v1/market/insights

Supply, demand, and pricing analytics

Analysis

POST/v1/pricing/insights

Comprehensive pricing analysis

Error Codes

Code	HTTP Status	Description
INVALID_API_KEY	401	API key is invalid or not found
INSUFFICIENT_BALANCE	402	Account balance too low
RATE_LIMIT_EXCEEDED	429	Too many requests
INVALID_VRM	400	VRM format is invalid
VEHICLE_NOT_FOUND	404	No data found for this VRM