Vehicle Valuation

The Valuation API can be used to determine the present retail & trade values for a specific vehicle.

To use the API, a Vehicle ID returned from the Vehicle Search API (by Plate, VIN or Plain Text) or Vehicle Facet API is required.

It is also preferable to provide the latest odometer reading or a prediction of the odometer as this can have an impact on the valuation (please see our vehicle search API for information on how we can predict the odometer reading). If an odometer reading is not specified, we will utilise a calculated average for the age of the vehicle.

This API has an optional bounds feature that will show the upper and lower bounds for the retail & trade values given.

Once a result is returned for the valuation, a score will be provided that indicates our confidence in the number. The following general guide can be applied to the score:

• High Confidence (e.g., >0.8): The valuation model is highly certain about the estimated retail value, supported by a large dataset and strong model accuracy

• Medium Confidence (e.g., 0.5–0.8): The prediction is reasonable but may require additional validation due to a smaller sample size or price volatility.

• Low Confidence (e.g., <0.5): The prediction is uncertain, often due to limited data availability or high market volatility.

Note: A low confidence score does not mean that it is wrong, it is our transparent way of letting you know the extent of the data we have access to to inform the valuation algorithm.

Retrieve a Market Value for a vehicle

post

Retrieve the retail and trade market valuation for a given vehicle

Query parameters

featuresstringOptional

Comma separated list of additional data packages to append to the core response

Example: bounds

Body

application/json

vehicle_idstringRequired

Vehicle id

Example: 6746602593058816

kmsintegerOptional

The mileage of a vehicle in kilometres

Example: 10000

rrp_overwriteintegerOptional

RRP overwrite

Example: 23

rrp_adjustmentintegerOptional

RRP adjustment

Example: 23

condition_scoreinteger · min: 1 · max: 5Optional

Condition score of the vehicle

Example: 5

regostringOptional

Plate/registration number of the vehicle

Example: EAN272

vinstringOptional

Vehicle Identification Number (VIN) of the vehicle

Example: JMYXTCW5W7Z000992

Responses

200

Valuations Response

application/json

400

Bad Request / Validation Failed

application/json

404

Resource for id cannot be found

application/json

500

Unknown error on the service side

application/json

post

HTTPcURLJavaScriptPython

POST /v1/valuations HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "vehicle_id": "6746602593058816",
  "kms": 10000,
  "rrp_overwrite": 23,
  "rrp_adjustment": 23,
  "condition_score": 5,
  "rego": "EAN272",
  "vin": "JMYXTCW5W7Z000992"
}

{
  "success": true,
  "prediction": {
    "id": "b2824bfd-d4a4-45e4-a81a-bed7b92c5cd9",
    "vehicle_id": 5257788510961664,
    "created_at": "2022-08-11T10:22:07.072Z",
    "kms": 21000,
    "price": 26000,
    "score": 0.85,
    "retail_price": 23000,
    "trade_price": 23000,
    "adjustment": {
      "vehicle_id": 5257788510961664,
      "trade_adjustment": {
        "amount": 100,
        "type": "fixed",
        "overridden": true
      },
      "retail_adjustment": {
        "amount": 100,
        "type": "fixed",
        "overridden": true
      },
      "overrides": [
        {
          "id": "7d1e9caa-b308-4b9f-b48f-29643dbbadf4",
          "min_kms": 30000,
          "max_kms": 35000,
          "trade_price": 52000,
          "retail_price": 52000
        }
      ]
    }
  },
  "bounds": {
    "retail": {
      "lower": 23000,
      "upper": 33000
    },
    "trade": {
      "lower": 23000,
      "upper": 33000
    }
  }
}