## List the files of an item (tenant:forge:read)

`GET /api/forge/v1/projects/{key}/items/{number}/attachments`

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

Requires `tenant:forge:read` and an item the caller sees. Oldest first; `source` upload or conversion (a file of the source item, the same DMS document).

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `key` | path | string | yes | Project key (e.g. APP) |
| `number` | path | integer | yes | Item number in the project (12 of APP-12) |

### Responses

- **200** Files (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of Attachment, required)
  - `createdAt` (string (date-time), required): When the file was added
  - `id` (string (uuid), required): Attachment id
  - `itemId` (string (uuid), required): The item the file belongs to
  - `mime` (string, required): MIME type
  - `name` (string, required): File name
  - `size` (integer, required): Size in bytes
  - `source` (string, required): `upload`: uploaded to the item; `conversion`: taken over by a conversion (one of `upload`, `conversion`)
  - `uploadedByRef` (string, required): E-mail of who uploaded it
  - `commentId` (string (uuid), nullable): The comment the file came with (conversions)

Example 200 answer:

```json
{
  "items": [
    {
      "commentId": null,
      "createdAt": "2026-11-06T08:45:00Z",
      "id": "5b6c7d8e-9f0a-4b1c-8d2e-4f5a6b7c8d01",
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c11",
      "mime": "application/pdf",
      "name": "Absturzbericht_iOS_17.pdf",
      "size": 48213,
      "source": "upload",
      "uploadedByRef": "ben.koch@muster-it.example"
    },
    {
      "commentId": null,
      "createdAt": "2026-11-06T08:44:00Z",
      "id": "5b6c7d8e-9f0a-4b1c-8d2e-4f5a6b7c8d02",
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c11",
      "mime": "image/png",
      "name": "Absturz_PDF_Anhang_iOS.png",
      "size": 182334,
      "source": "upload",
      "uploadedByRef": "ben.koch@muster-it.example"
    }
  ]
}
```

### Example request

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