---
title: "List threads in an inbox"
method: GET
path: "/email_inboxes/{inbox_id}/threads"
tags: ["Email Inboxes"]
---

# List threads in an inbox

`GET /email_inboxes/{inbox_id}/threads`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/email_inboxes/{inbox_id}/threads`
- Auth: HTTP bearer

Lists thread summaries newest first using stable cursor pagination.

## Path parameters

- `inbox_id` string, uuid, required

## Query parameters

- `page[size]` integer
- `page[after]` string
- `filter[label]` string

## Response `200`

Paginated inbox threads.

- InboundThreadListResponse
  - `data` InboundThread[], required
    - `id` string, uuid, required
    - `record_type` 'email_thread', required
    - `inbox_id` string, uuid, required
    - `subject` string, nullable, required
    - `preview` string, nullable, required
    - `message_count` integer, required: Total inbound and outbound messages in the thread.
    - `unread_count` integer, required: Unread inbound messages; outbound messages never increment this count.
    - `last_message_id` string, uuid, required
    - `last_message_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `labels` string[], required: Mutable thread labels used for agent workflow state. Independent of the labels on the thread's messages, and distinct from the send-time `tags` on outbound messages.
  - `meta` EmailPaginationMeta, required
    - `page_size` integer, required
    - `page_cursor` string: Cursor for the next page, when more results are available.

## Other responses

- `401`: Not authorized (10006).
- `404`: Resource not found (10001).
- `422`: Validation Failed (10015) or changeset validation error.
- `503`: Inbound thread storage is temporarily unavailable.

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/email_inboxes/:inbox_id/threads/get.md)

---

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