---
title: "Get The Crop History Of The Utilised Agricultural Area For Each Year And The Soil Turning Percentage"
method: GET
path: "/agri/async/get-crop-change-history/{id}"
tags: ["AGRI endpoints"]
---

# Get The Crop History Of The Utilised Agricultural Area For Each Year And The Soil Turning Percentage

`GET /agri/async/get-crop-change-history/{id}`

## Request

- Base URL: `https://api.nimbo.earth` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nimbo.earth/agri/async/get-crop-change-history/{id}`
- Auth: API key in query parameter `kermap_token`
- TypeScript: <https://skmtc.dev/nimbo/apis/nimbo-api/docs/agri/async/get-crop-change-history/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a json file containing the crop history of the utilised agricultural area for each year and the soil turning percentage.

In case of success:
```
{
    "ready": true,
    "successful": true,
    "value": {
        "calc_date": "2025-06-12T08:28:33.345729",
        "SAU_area": 52.5,
        "total_pph_evolution": -5,
        "soil_turning_percent": 10,
        "history_of_SAU_crops": [...]
    }
}
```
In case of error:
```
{
    "ready": true,
    "successful": false,
    "value": {
        "error_message": "Invalid geometry provided",
    }
}
```

## Path parameters

- `id` string, required

## Response `200`

OK

- unknown

## Other responses

- `403`: Unauthorized: You need a KERMAP Token
- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/nimbo/apis/nimbo-api.md) - [All operations](https://skmtc.dev/nimbo/apis/nimbo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nimbo/apis/nimbo-api/revisions/33ea0b26547a?raw)