Inboxes

List threads

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.

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

Path parameters

inbox_idstring required

The inbox id or its email address

Query parameters

folder'inbox' | 'archive' | 'spam' | 'sent' | 'trash'
querystring
labelstring[]

Label ids; repeat the parameter or separate with commas

limitinteger
afterstring

The id of the last thread on the page; returns the next, older page

beforestring

The id of the first thread on the page; returns the previous, newer page. Not with after.

Response

A page of threads

objectstring
has_moreboolean

Example response

{
  "object": "list"
}

Changes

No recorded changes to this operation across all 1 revision of this API.