## Complete change history (desk:read)

`GET /api/desk/v1/items/{ref}/events`

Module: Desk · operationId: `listItemEvents` · Tag: Activity · Auth: access token (`Authorization: Bearer <accessToken>`)

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer |  | Rows per page (default 200) (default `200`; max 500) |
| `cursor` | query | string |  | The `nextCursor` of the previous page (keyset, bound to the list and its order); anything else is 400 invalid with `field: cursor`. |
| `ref` | path | string | yes | Item id or number |

### Responses

- **200** Events (`application/json`)

Fields of the 200 answer:

- `items` (array of Event, required)
  - `action` (string): What happened (created, updated, transitioned, …)
  - `actorName` (string): Name of who made the change
  - `actorRef` (string): Login (e-mail) of who made the change
  - `changes` (array of object): Changed fields
    - `field` (string): Changed field
    - `from` (any): Value before
    - `to` (any): Value after
  - `createdAt` (string (date-time)): When the change happened
  - `id` (string): Id of the history entry
  - `itemId` (string): Item the change belongs to
  - `reason` (string): Why the change was made
- `nextCursor` (string): Cursor of the next page (pass it as `cursor`); missing on the last page.

Example 200 answer:

```json
{
  "items": [
    {
      "action": "transitioned",
      "actorName": "Sophie Huber",
      "actorRef": "sophie.huber@muster-it.example",
      "changes": [
        {
          "field": "status",
          "from": "neu",
          "to": "in_bearbeitung"
        }
      ],
      "createdAt": "2026-11-17T07:21:00Z",
      "id": "7c4d5e6f-8a9b-4c0d-9e1f-2a3b4c5d6e01",
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "reason": ""
    },
    {
      "action": "updated",
      "actorName": "Lukas Wimmer",
      "actorRef": "lukas.wimmer@muster-it.example",
      "changes": [
        {
          "field": "labelIds",
          "from": [
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d02"
          ],
          "to": [
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d02",
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d01"
          ]
        }
      ],
      "createdAt": "2026-11-17T08:46:00Z",
      "id": "7c4d5e6f-8a9b-4c0d-9e1f-2a3b4c5d6e02",
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "reason": ""
    }
  ],
  "nextCursor": "eyJpZCI6IjdjNGQ1ZTZmIn0"
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/items/string/events' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
