Get Vehicle Valuation

Value a vehicle

post

Retrieve the valuation for a given plate or vin

Query parameters

featuresstringOptional

Comma separated list of additional registration lookup data codes

Example: bounds

reference_idstringOptional

An optional reference id which will be stored against usage records if supplied

Example: MY_REFERENCE_123

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

/v1/valuations

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