Condition Array Valuation

Run automated valuations at all condition scores.

Building on our standard valuation system you can hit a single endpoint to deliver an array of all valuations across each condition score.

Value a vehicle using an AutoGrab ID without requiring a condition_score, return multiple valuations, one for each allowable condition_score [1-5]

post

Value a vehicle using an AutoGrab ID without requiring a condition_score, return multiple valuations, one for each allowable condition_score [1-5]

Authorizations

ApiKeyAuth

ApiKeystringRequired

Body

application/json

regionstring · enumOptionalPossible values:

vehicle_idstringRequired

The AutoGrab Vehicle ID which corresponds to the vehicle that should be valued

kmsnumberOptional

The odometer reading of the vehicle. If no reading is provided, the average value will be subsituted

rrp_overwritenumberOptional

rrp_adjustmentnumberOptional

regostringOptional

The registration plate of the vehicle, for reference purposes only

statestringOptional

The registration state of the vehicle, if applicable

vinstringOptional

The VIN of the vehicle, for reference purposes only

Responses

200

Success

application/json

successbooleanOptionalDefault: true

400

Bad Request

application/json

401

Unauthorized

application/json

post

/v2/valuations/predict/conditions

HTTPcURLJavaScriptPython

POST /v2/valuations/predict/conditions 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",
  "kms": 1,
  "rrp_overwrite": 1,
  "rrp_adjustment": 1,
  "rego": "text",
  "state": "text",
  "vin": "text"
}

{
  "success": true,
  "prediction": {
    "id": "text",
    "vehicle_id": "text",
    "created_at": "text",
    "kms": 1,
    "price": 1,
    "score": 1,
    "retail_price": 1,
    "trade_price": 1,
    "adjustment": {
      "vehicle_id": "text",
      "type": "account",
      "enabled": true,
      "trade_adjustment": {
        "amount": 1,
        "type": "fixed"
      },
      "retail_adjustment": {
        "amount": 1,
        "type": "fixed"
      },
      "overrides": [
        {
          "id": "text",
          "min_kms": 1,
          "max_kms": 1,
          "trade_price": 1,
          "retail_price": 1
        }
      ]
    },
    "conditions": [
      {
        "condition_score": 1,
        "trade_price": 1
      }
    ]
  },
  "bounds": {
    "retail": {
      "lower": 1,
      "upper": 1
    },
    "trade": [
      {
        "condition_score": 1,
        "lower": 1,
        "upper": 1
      }
    ]
  }
}

For example if you wished to return each condition value for AGID 0151142767745437 follow the steps below.

curl --location 'https://api.autograb.com.au/v2/valuations/predict/conditions' \
--header 'Content-Type: application/json' \
--header 'ApiKey: YOURKEY' \
--data '{
    "region": "au",
    "vehicle_id": "0151142767745437",
    "kms": 30000
}'

And the sytem will respond with an array of valuations.

{
    "success": true,
    "prediction": {
        "id": "904c5be2-93c1-4d97-bedd-9f3b48718478",
        "vehicle_id": "0151142767745437",
        "kms": 30000,
        "price": 49766,
        "score": 0.7869,
        "retail_price": 49766,
        "adjustment": null,
        "conditions": [
            {
                "condition_score": 1,
                "trade_price": 29610.7
            },
            {
                "condition_score": 2,
                "trade_price": 33840.8
            },
            {
                "condition_score": 3,
                "trade_price": 38070.9
            },
            {
                "condition_score": 4,
                "trade_price": 40185.95
            },
            {
                "condition_score": 5,
                "trade_price": 42301
            }
        ]
    }
}