---
title: "List threads across every inbox in the account"
method: GET
path: "/email_threads"
tags: ["Email Threads"]
---

# List threads across every inbox in the account

`GET /email_threads`

Lists thread summaries for the whole account, newest first, using stable
cursor pagination. An agent operating many inboxes gets every
conversation in one call instead of one call per inbox. Each thread
carries its own `inbox_id` so a reply can be routed back to the right
inbox. Use `filter[inbox_id]` (repeatable) to narrow the result to
specific inboxes. Because a thread ID can be delivered to multiple
inboxes, each result is identified by its `(inbox_id, id)` pair.

## Query parameters

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

## Response `200`

Paginated account-wide 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/revisions/8f5f4e537994/schema)