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

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

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

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

### Parameters

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

### Responses

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

Fields of the 200 answer:

- `items` (array of MilestoneView, required)

Example 200 answer:

```json
{
  "items": [
    {
      "closedAt": "2026-11-04T10:00:00Z",
      "createdAt": "2026-09-23T10:00:00Z",
      "description": "Erste Version im App Store und bei Google Play mit Anmeldung per Passkey.",
      "dueOn": "2026-11-04",
      "id": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c01",
      "position": 0,
      "progress": {
        "byCategory": {
          "active": 0,
          "cancelled": 1,
          "done": 8,
          "on_hold": 0,
          "todo": 0,
          "triage": 0
        },
        "estimate": {
          "done": 28,
          "total": 28
        },
        "total": 9
      },
      "releaseProvider": "github",
      "releaseRepo": "mbcomdev/demo-app",
      "releaseTag": "v1.0.0",
      "state": "closed",
      "title": "Version 1.0 – Anmeldung",
      "updatedAt": "2026-11-04T10:00:00Z",
      "version": 3
    },
    {
      "closedAt": null,
      "createdAt": "2026-09-30T13:00:00Z",
      "description": "Kunden sehen ihre Tickets mit Filtern, Seitenwechseln und einem verständlichen leeren Zustand.",
      "dueOn": "2026-11-25",
      "id": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c02",
      "position": 1,
      "progress": {
        "byCategory": {
          "active": 2,
          "cancelled": 0,
          "done": 5,
          "on_hold": 0,
          "todo": 2,
          "triage": 0
        },
        "estimate": {
          "done": 12,
          "total": 25
        },
        "total": 9
      },
      "releaseProvider": "github",
      "releaseRepo": null,
      "releaseTag": null,
      "state": "open",
      "title": "Version 1.1 – Ticketübersicht",
      "updatedAt": "2026-10-21T10:15:00Z",
      "version": 2
    }
  ]
}
```

### Example request

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