---
title: "List the attachments of an item"
method: GET
path: "/projects/{projectId}/items/{itemId}/attachments"
tags: ["Items"]
---

# List the attachments of an item

`GET /projects/{projectId}/items/{itemId}/attachments`

## Request

- Base URL: `https://app.ketryx.com/api/v1`
- URL: `https://app.ketryx.com/api/v1/projects/{projectId}/items/{itemId}/attachments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ketryx/apis/ketryx-api/docs/projects/:projectId/items/:itemId/attachments/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the attachments of the item's current record. Requires the GET_ITEMS capability.

## Response `200`

Attachments of the current record

- object
  - `attachments` ItemAttachment[], required
    - `id` string, required: Ketryx ID of the attachment
    - `filename` string, nullable
    - `contentType` string, required
    - `sizeBytes` integer, nullable
    - `createdAt` string, date-time, required
    - `url` string, required: URL to download the attachment. For files uploaded to Ketryx it is the same URL the upload returned and accepts API keys; for attachments synced from an external system it opens in a signed-in browser session only.

## Other responses

- `401`: The requester is not authenticated.
- `403`: The requester is unauthorized.
- `404`: The resource was not found.

---

[API](https://skmtc.dev/ketryx/apis/ketryx-api.md) - [All operations](https://skmtc.dev/ketryx/apis/ketryx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ketryx/apis/ketryx-api/revisions/a2a484dc35ca?raw)