> For the complete documentation index, see [llms.txt](https://devhub.autotek.my/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devhub.autotek.my/valuation/residual-valuations.md).

# Residual Valuations

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 AutoGrab's stored Recommended Retail Price, or by providing your own Retail Value for the car.

In the example below we are sending the vehicle ID along with other key details to /v2/valuations/residual. The example body of the post is below.

```postman_json
{
    "region": "au",
    "vehicle_id": "5804870883868672",
    "initial_kms": 30000,
    "yearly_kms": 20000
}
```

This yields a prediction over the 5 year projection timeframe as below. 

```json
{
    "success": true,
    "predictions": [
        {
            "year": 0,
            "kms": 30000,
            "valuation": 23103,
            "score": 0.818203282
        },
        {
            "year": 1,
            "kms": 50000,
            "valuation": 20601,
            "score": 0.81823397
        },
        {
            "year": 2,
            "kms": 70000,
            "valuation": 18323,
            "score": 0.818168287
        },
        {
            "year": 3,
            "kms": 90000,
            "valuation": 16250,
            "score": 0.818181818
        },
        {
            "year": 4,
            "kms": 110000,
            "valuation": 14365,
            "score": 0.818124288
        },
        {
            "year": 5,
            "kms": 130000,
            "valuation": 12655,
            "score": 0.818175287
        }
    ]
}
```