---
title: "Launch The Crop History Calculation"
method: POST
path: "/agri/async/launch-crop-change-history"
tags: ["AGRI endpoints"]
---

# Launch The Crop History Calculation

`POST /agri/async/launch-crop-change-history`

## 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/launch-crop-change-history`
- Auth: API key in query parameter `kermap_token`
- TypeScript: <https://skmtc.dev/nimbo/apis/nimbo-api/docs/agri/async/launch-crop-change-history/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a key to be used in the "get-cover" endpoint to obtain the duration of ground coverage of the geojson sent.
```
{
    "id": "45a167a1-32a6-4082-452135-be839b1714224"
}
```

## Query parameters

- `year` integer: YEAR of the dataset to query - defaults to last year of available dataset

## Request body

- object: EPSG:4326 Geojson FeatureCollection request body

## 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)