Adjustments

Adjust valuations we send you based on a rule set.

Both the Residual Value and Used Value APIs support pricing adjustments. These can be used to retrieve a more accurate price prediction of a vehicle if the provided price is not already accurate enough.

Recommended Retail Price Adjustment

To adjust the stored Recommended Retail Price you can supply a rrp_adjustment value in the payload which accepts a number — positive or negative.

This is useful when a car is fitted with factory extras, the Price When New can be increased for each of the options to get a better price prediction.

Recommended Retail Price Overwrite

To overwrite the systems stored Recommended Retail Price with your own, use the rrp_overwrite value in the payload which accepts a number.

Predicted Retail and Trade Price Adjustments

The Pricing Adjustments API (/v2/valuations/adjustments) allows you to configure fixed or percentage adjustments for specific Vehicle IDs.

Per-vehicle pricing adjustments will apply to price predictions that you perform using the same API Key and for the same Vehicle ID.

If you set a Retail Price Adjustment for a vehicle, the trade price will also be affected because the trade price is derived from the retail price. If you set an adjustment for both the retail price and the trade price, both adjustments will be applied to the trade price while the retail price is only affected by the retail price adjustment.

When you perform a price prediction, you will receive a summary of the price adjustments that were applied, if any.

Predicted Retail/Trade Adjustments do not apply to residual valuations.

Example

Below is an example price prediction payload with predicted trade and retail adjustments applied.

{
    "success": true,
    "prediction": {
        "id": "d028809e-0ef5-42de-9699-8b71fd1aee65",
        "vehicle_id": "5631424535199744",
        "price": 12347,
        "score": 0.81820,
        "retail_price": 14847,
        "trade_price": 2042.46,
        "adjustment": {
            "vehicle_id": "5631424535199744",
            "enabled": true,
            "retail_adjustment": {
                "type": "fixed",
                "amount": 2500,
                "overridden": false
            },
            "trade_adjustment": {
                "type": "percentage",
                "amount": 0.2,
                "overridden": false
            },
            "overrides": []
        }
    }
}

Predicted Retail and Trade Price Overrides

As well as Price Adjustments, you also have the option to override Retail and Trade prices for specific Vehicle IDs where the odometer reading falls within a set range. Price overrides are configured using the Price Override API at /v2/valuations/adjustments/{VEHICLE_ID}/overrides.

If you have configured a retail or trade price override that applies to a price prediction, the overridden price will be returned instead of the AutoGrab valuation. This will bypass any price adjustments that you may have configured, and the response payload will indicate this with the {overridden: true} flag.

Retail price overrides will impact the predicted trade price in the same way that retail price adjustments impact the trade price - unless you have configured a trade price override. In the case where you have both a trade override and a retail override, the two overridden prices will be returned without any pre-processing (except to calculate condition scores, if applicable - see below).

As with Predicted Retail/Trade Adjustments, price overrides do not apply to residual valuations

Example

Below is an example price prediction payload where both price adjustments and price overrides have been configured. In this example, the retail price adjustment has been overridden by the retail price override, and the trade price adjustment has been applied.

{
    "success": true,
    "prediction": {
        "id": "faa847f1-d428-46e1-b2d6-b47a00173d6e",
        "vehicle_id": "5631424535199744",
        "price": 11697,
        "score": 0.81820,
        "retail_price": 12000,
        "trade_price": 1700,
        "adjustment": {
            "vehicle_id": "5631424535199744",
            "retail_adjustment": {
                "type": "fixed",
                "amount": 2500,
                "overridden": true
            },
            "trade_adjustment": {
                "type": "percentage",
                "amount": 0.2,
                "overridden": false
            },
            "overrides": [
                {
                    "id": "1ef42b79-c580-4055-a39b-e5257f81d0d9",
                    "min_kms": 80000,
                    "max_kms": 90000,
                    "trade_price": null,
                    "retail_price": 12000
                }
            ]
        }
    }
}