---
title: "List a thread message's attachments"
canonical: "https://bird.com/docs/api/reference/list-email-thread-message-attachments"
---

# List a thread message's attachments

`GET /v1/email/threads/{thread_id}/messages/{message_id}/attachments`

Returns the attachments on a message in a conversation. Attachment bytes are downloadable for the mailbox's retention tier after the message occurred. Later requests return `410 Gone`, while the attachment metadata stays readable on the message's `attachment_manifest`.

## Code samples

**TypeScript**

```ts
const atts = await bird.email.threads.messages.attachments("thr_01abc", "rem_01xyz");
console.log(atts.data.map((a) => a.filename));
```

Examples: [TypeScript](/docs/api/reference/list-email-thread-message-attachments.ts.md) · [Python](/docs/api/reference/list-email-thread-message-attachments.py.md) · [Go](/docs/api/reference/list-email-thread-message-attachments.go.md) · [PHP](/docs/api/reference/list-email-thread-message-attachments.php.md) · [CLI](/docs/api/reference/list-email-thread-message-attachments.cli.md) · [MCP](/docs/api/reference/list-email-thread-message-attachments.mcp.md) · [cURL](/docs/api/reference/list-email-thread-message-attachments.curl.md)

## Example response `200`

```json
{
  "data": [
    {
      "id": "rea_01krdgeqcxet5s7t44vh8rt9mg",
      "filename": "invoice.pdf",
      "content_type": "application/pdf"
    }
  ]
}
```

## Path parameters

- `thread_id` (string): Thread identifier. Starts with `thr_`.
- `message_id` (string): Message ID (`rem_` for a received message, `em_` for a sent one).

## Response body

- `data` (array of object, required)
- `data.id` (string, required): Attachment ID, used to download the attachment bytes.
- `data.filename` (nullable string, required): Original filename, or null when the attachment had none.
- `data.content_type` (nullable string, required): MIME content type, or null when it could not be determined.
- `data.size` (integer, required): Attachment size in bytes.

## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Email](/email-api) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=email)