Residual Valuations

Predict the future value of a vehicle.

The Residual Value prediction API uses current market trends to influence the depreciation curve of newer vehicles. The API allows you to influence the outcome of the prediction by either mutating stored Recommended Retail Price, or by providing your own Retail Value for the car.

Calculate future values for a vehicle using an AutoGrab ID

post

Calculate future values for a vehicle using an AutoGrab ID

Authorizations

ApiKeystringRequired

Body

regionstring · enumOptionalPossible values:

vehicle_idstringRequired

initial_kmsnumberOptionalDefault: 0

yearly_kmsnumberRequiredDefault: 10000

rrp_overwritenumberOptional

rrp_adjustmentnumberOptional

colorstringOptional

Responses

200

Success

application/json

successbooleanOptionalDefault: true

400

Bad Request

application/json

401

Unauthorized

application/json

post/v2/valuations/residual

POST /v2/valuations/residual HTTP/1.1
Host: api.autograb.com.au
ApiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "region": "au",
  "vehicle_id": "text",
  "initial_kms": 0,
  "yearly_kms": 10000,
  "rrp_overwrite": 1,
  "rrp_adjustment": 1,
  "color": "text"
}

{
  "success": true,
  "predictions": [
    {
      "year": 1,
      "kms": 1,
      "valuation": 1,
      "score": 1
    }
  ]
}