curl -X GET 'https://api.resend.com/inboxes/inbox-id/threads?folders=example&labels=example&read=true&limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

# GET /inboxes/{inbox_id}/threads (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-10-20

> Retrieve a list of inbox threads

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.

## cURL
curl -X GET 'https://api.resend.com/inboxes/inbox-id/threads?folders=example&labels=example&read=true&limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| inbox_id | path | string | Yes | The Inbox ID or the inbox email address, such as `support... |
| folders | query | string[] | No | Comma-separated folders to list, for example `inbox,sent`... |
| labels | query | string[] | No | Comma-separated label IDs. Returns threads with any of th... |
| read | query | boolean | No | `true` returns threads where every email is read. `false`... |
Other params: limit, after, before

## Response (200 OK)
{"object":"list","has_more":true}

---
Need an API key? Get one at https://resend.com/signup

GET

GET /inboxes/{inbox_id}/threads — Resend API

Resend API

Retrieve a list of inbox threads

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 229 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

cURL

curl -X GET 'https://api.resend.com/inboxes/inbox-id/threads?folders=example&labels=example&read=true&limit=10&after=example-after&before=example-before' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0'

Parameters

Name	In	Type	Required	Description
inbox_id	path	string	Yes	The Inbox ID or the inbox email address, such as `[email protected]`. A value that contains `@` must be a valid email address, and any other value must be a UUID, or the request returns a 422. The address match is case-insensitive and never falls back to the inbox `name`. An address that matches no inbox returns a 404.
folders	query	string[]	No	Comma-separated folders to list, for example `inbox,sent`. Repeating the parameter returns a 422 validation_error. A thread is returned when any of its emails is in one of the folders, so a thread in `inbox` with an email you sent matches both `inbox` and `sent`. Defaults to `inbox`, or to `inbox,archive,sent` when `labels` is set. `spam` and `trash` are only included when you name them.
labels	query	string[]	No	Comma-separated label IDs. Returns threads with any of these labels. Up to 50 IDs. An ID that does not exist in the inbox returns a 404. Repeating the parameter returns a 422 validation_error.
read	query	boolean	No	`true` returns threads where every email is read. `false` returns threads with at least one unread email. Only the literal values `true` and `false` are accepted.
limit	query	integer	No	Number of items to return.
after	query	string	No	Return items after this cursor.
before	query	string	No	Return items before this cursor.

Response 200 OK

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12",
      "subject": "Refund for order 1041",
      "from": "[email protected]",
      "to": [
        "[email protected]"
      ],
      "cc": [],
      "bcc": [],
      "labels": [
        {
          "id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
          "name": "Urgent",
          "color": "#E93D82"
        }
      ],
      "email_count": 2,
      "has_attachment": true,
      "has_draft": false,
      "read": false,
      "received_at": "2026-08-05T14:03:11.229Z",
      "folder": "inbox"
    }
  ]
}

Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.