## List the iterations of a project (tenant:forge:read)

`GET /api/forge/v1/projects/{key}/iterations`

Module: Forge · operationId: `listForgeIterations` · Tag: Iterations · Auth: access token (`Authorization: Bearer <accessToken>`)

Requires `tenant:forge:read` and a project the caller sees. Each iteration carries its `progress`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `state` | query | string |  | (one of `planned`, `active`, `closed`) |
| `key` | path | string | yes | Project key (e.g. APP) |

### Responses

- **200** The iterations (`application/json`)
- **400** Error (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of IterationView, required)

Example 200 answer:

```json
{
  "items": [
    {
      "closedAt": "2026-11-04T08:30:00Z",
      "createdAt": "2026-10-07T10:00:00Z",
      "endsOn": "2026-11-03",
      "goal": "Anmeldung mit Passkey auf iOS und Android, Fehlermeldungen verständlich.",
      "id": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d01",
      "name": "Iteration 1 – Anmeldung",
      "position": 0,
      "progress": {
        "byCategory": {
          "active": 0,
          "cancelled": 1,
          "done": 5,
          "on_hold": 0,
          "todo": 1,
          "triage": 0
        },
        "committed": 21,
        "estimate": {
          "done": 18,
          "total": 22
        },
        "total": 7
      },
      "startedAt": "2026-10-14T09:30:00Z",
      "startsOn": "2026-10-14",
      "state": "closed",
      "updatedAt": "2026-11-04T08:30:00Z",
      "version": 4
    },
    {
      "closedAt": null,
      "createdAt": "2026-10-28T11:00:00Z",
      "endsOn": "2026-11-24",
      "goal": "Kunden sehen ihre Tickets mit Filtern und laden lange Listen nach.",
      "id": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d02",
      "name": "Iteration 2 – Ticketübersicht",
      "position": 1,
      "progress": {
        "byCategory": {
          "active": 2,
          "cancelled": 0,
          "done": 4,
          "on_hold": 0,
          "todo": 1,
          "triage": 0
        },
        "committed": 16,
        "estimate": {
          "done": 9,
          "total": 19
        },
        "total": 7
      },
      "startedAt": "2026-11-04T09:30:00Z",
      "startsOn": "2026-11-04",
      "state": "active",
      "updatedAt": "2026-11-04T09:30:00Z",
      "version": 3
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/iterations' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
