---
title: "List threads"
method: GET
path: "/v1/inboxes/{inbox_id}/threads"
tags: ["Inboxes"]
---

# List threads

`GET /v1/inboxes/{inbox_id}/threads`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/inboxes/{inbox_id}/threads`
- Auth: HTTP bearer

Threads in one folder, most recently active first. query matches the subject and label names (case-insensitive, up to 256 characters); label filters to threads carrying any of the given label ids. read is true only when every message is read; it follows the same read state as the received email API. folder, unread_count and snippet are not in Resend. Requires the inbound:read scope.

## Path parameters

- `inbox_id` string, required

## Query parameters

- `folder` 'inbox' | 'archive' | 'spam' | 'sent' | 'trash'
- `query` string
- `label` string[]
- `limit` integer
- `after` string
- `before` string

## Response `200`

A page of threads

- object
  - `object` string
  - `has_more` boolean
  - `data` InboxThreadListItem[]
    - `id` string
    - `subject` string, nullable
    - `from` string, nullable: Sender of the most recent message
    - `to` string[]
    - `cc` string[]
    - `bcc` string[]
    - `labels` InboxLabelRef[]
      - `id` string
      - `name` string
      - `color` 'cyan' | 'teal' | 'grass' | 'lime' | 'yellow' | 'orange' | 'iris' | 'plum' | 'crimson' | 'bronze' | 'mauve'
    - `message_count` integer
    - `has_attachment` boolean
    - `has_draft` boolean
    - `read` boolean
    - `received_at` string, date-time
    - `folder` string: Not in Resend's list item
    - `unread_count` integer: Unread messages in the thread. Not in Resend.
    - `snippet` string, nullable: A preview of the most recent message. Not in Resend.

## Other responses

- `400`: Bad request - check your payload
- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `404`: Resource not found
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)