---
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`

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.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)