API
Sign Up

Car valuation API: trade, retail, private and part exchange values

Last updated: 9 November 2026

POST a registration or VIN, and optionally the mileage, to /api/v1/vehicle/valuation and you get retail, trade, private, part exchange and auction values in pounds, plus the detailed figures behind them (trade retail, trade average, trade poor, private clean, private average, on the road and dealer forecourt). It costs 25p a call on Pay As You Go, down to 16p 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.

Send mileage for a mileage-adjusted figure; without it the valuation uses a standard mileage for the car, and mileage_used says which mileage the figures are for.

For prices from today's market as well (cars like this one for sale and sold in the last 90 days), add the pricing insights or market insights endpoints, or see the used car price data API.

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
Valuation
POST /api/v1/vehicle/valuation
Retail, trade, private, part exchange and auction values, optionally at a given mileage.
Daily cap per account: 200 / 500 / 1,500 / 5,000
25p21p19p16p
DP valuation
POST /api/v1/vehicle/dp-valuation
The DealerPricing retail value our dealer dashboard shows, worked out from comparable cars for sale and sold at your mileage.
30p25p22p18p
Pricing insights
POST /api/v1/pricing/insights
Where an asking price sits in the market, with a recommended range from live and sold adverts.
Daily cap per account: 200 / 750 / 2,000 / 5,000
10p8p6p4p
Market insights
POST /api/v1/market/insights
Supply, demand, sold prices and days to sell for cars like this one.
Daily cap per account: 200 / 750 / 2,000 / 5,000
10p8p6p4p

Price change: from 15 December 2026, pricing insights is 20p Pay As You Go, 16p Starter, 14p Pro, 12p Enterprise.

Price change: from 15 December 2026, market insights is 20p Pay As You Go, 16p Starter, 14p Pro, 12p Enterprise.

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/valuation \
  -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": {
    "valuation": {
      "vrm": "SA22TLZ",
      "mileage_used": 14424,
      "currency": "GBP",
      "valuations": {
        "retail": 15186,
        "trade": 12680,
        "private": 13360,
        "part_exchange": 13303,
        "auction": 13286
      },
      "figures": {
        "on_the_road": 19225,
        "dealer_forecourt": 15186,
        "trade_retail": 14596,
        "trade_average": 12680,
        "trade_poor": 11769,
        "private_clean": 13512,
        "private_average": 13360,
        "part_exchange": 13303,
        "auction": 13286
      },
      "valuation_date": "2026-09-06",
      "valued_at": "2026-09-06T21:11:19.4516511Z",
      "valuation_book": "Direct",
      "vehicle_summary": {
        "description": "Volkswagen Polo Life TSi Life TSI [Petrol / Manual]",
        "first_registered": "2022-04-23"
      },
      "raw": {}
    }
  },
  "meta": {
    "request_id": "req_3f9a1c0d2b7e4a5f6c8d9e01",
    "cost_pence": 25,
    "balance_pence": 975,
    "is_sandbox": false
  }
}

What you get

valuation.valuations.retail
Headline values: retail, trade, private, part_exchange and auction
valuation.figures.trade_retail
Trade figures: trade_retail, trade_average and trade_poor
valuation.figures.private_clean
Private figures: private_clean and private_average
valuation.figures.on_the_road
On the road price and dealer_forecourt figure
valuation.mileage_used
The mileage the figures are for
valuation.valuation_date
When the valuation was produced (valuation_date and valued_at)
valuation.vehicle_summary.description
A one-line description of the car and its first registration date

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

What developers use it for

  • A "value my car" or part exchange form on a dealer website.
  • Check a trade buying price against retail before you bid.
  • Price stock in a dealer management system from the registration.

Questions

Is there a car valuation API for the UK?

Yes. DealerPricing's /api/v1/vehicle/valuation returns retail, trade, private, part exchange and auction values for a UK registration or VIN, for 25p a call on Pay As You Go, down to 16p on Enterprise.

Can I value a car at a specific mileage?

Yes. Send mileage in miles and the figures are adjusted for it. Without it a standard mileage is used, and mileage_used tells you which.

How much does a valuation cost?

Pay As You Go 25p, Starter 21p, Pro 19p, Enterprise 16p a call. On the monthly packages the whole fee comes back as plan credit to spend on calls. It expires at the end of each monthly billing period. A vehicle that is not found is not charged.

Is there a free car valuation API for testing?

Sandbox keys are free. Sandbox valuations are stored for the test registrations and do not change with mileage, so use them to build and test, then switch to a live key for real figures.

Are the values based on live adverts?

No. The valuation endpoint returns valuation figures for the vehicle. Prices from live and sold adverts come from separate endpoints: pricing insights, market insights and the market data endpoints.

How many valuations can I make a day?

Valuation has a daily cap per account: Pay As You Go 200, Starter 500, Pro 1,500, Enterprise 5,000.

Documentation and next steps