Skip to content
Sendtier Docs
Dashboard

Get one thread and its message metadata

Requires a full key or an inbox key (bound inbox only). A thread in another tenant, the other mode, or a deleted inbox is not found. Deleted and expired messages are omitted. Messages are paginated oldest first by received_at and id. The default limit is 50, maximum 100. Use next_cursor as after to read the next message page. message_count is the stored thread count, independent of this page.

GET/v1/threads/{thread_id}

Path parameters

ParameterDescription
thread_idrequired
string

Query parameters

ParameterDescription
limit
integer
after
string

Cursor from next_cursor of the previous page.

Full parameter schemas and constraints

Path Parameters

thread_id*string

Query Parameters

limit?integer
Range1 <= value <= 100
Default50
after?string

Cursor from next_cursor of the previous page.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key: st_live_... or st_test_...

Response Body

The thread and its message metadata, oldest first.

application/json
  1. response
id*string
inbox_id*string
subject*string
message_count*integer
last_message_at*string
Formatdate-time
created_at*string
Formatdate-time
messages*array<>
Itemsitems <= 100
next_cursor?string

Cursor for the next page of messages, oldest first.