Valuation Features

Generate upper and lower bounds on each valuation.

Positive Equity

The positive equity feature identifies if the vehicle is in positive equity and the current equity position. To add an equity calculation to the Predict call, use features=equity:

/v2/valuations/predict?features=equity

{
    "success": true,
    "prediction": {
        "id": "599aff94-7c79-4b9c-a976-ff39c3892190",
        "vehicle_id": "4825547834130432",
        "kms": 20000,
        "price": 32669,
        "score": 0.8515,
        "retail_price": 32669,
        "trade_price": 27769,
        "adjustment": null
    },
    "equity": {
        "positive_equity": true,
        "equity_position": 15769
    }
}

Valuation Bounds

If you require the upper and lower bounds used to calculate a prediction, you can use features=bounds.

This will yield the bounds on the retail and trade prices.

/v2/valuations/registrations/BMT038?features=bounds

{
    "success": true,
    "prediction": {
        "id": "e2813b16-1012-41b5-9ea3-3b65675c50fd",
        "vehicle_id": "5804870883868672",
        "kms": 57306,
        "price": 20622,
        "score": 0.9239,
        "retail_price": 20622,
        "trade_price": 17122,
        "adjustment": null
    },
    "bounds": {
        "retail": {
            "lower": 19622,
            "upper": 21872
        },
        "trade": {
            "lower": 16122,
            "upper": 18372
        }
    }
}

Max Offer Adjustments

If you have a max offer profile setup via API or via the AutoGrab web app you can opt to receive the same results via API. Use features=max_offer to receive them in your response.

/v2/valuations/predict?features=max_offer

{
    "success": true,
    "prediction": {
        "id": "8ff23a62-110e-48d7-8205-672af45f6103",
        "vehicle_id": "5016997049925632",
        "kms": 30000,
        "price": 56083,
        "score": 0.858,
        "retail_price": 56083,
        "trade_price": 47671,
        "adjustment": null
    },
    "max_offer": {
        "reconditioning": 1250,
        "profit_margin": 6729.96,
        "lot": 1000,
        "transport": 300,
        "admin": 150,
        "price": 46653.04
    }
}

If you want to set or update your Max Offer configuration over API view the guide here.