GET/v1/messages

List message threads

Lists message threads, with optional filtering by status and pagination controls. Use limit to set the maximum number of results and offset to skip results.

3 parameters
limitintegeroptional
Maximum number of threads to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
offsetintegeroptional
Number of threads to skip. Must be zero or greater. Defaults to 0 when omitted.
Default:0
statusstringoptional
Filter threads by status: `open` or `closed`.
Allowed:openclosed

2 status codes
200Returns a paginated response containing an array of threads in `data` and pagination metadata, including `limit`, `offset`, and `has_more`.
dataarray<object>optional
paginationobjectoptional
401Returned when the request is unauthenticated.
errorobjectoptional

Error handling

A 401 is returned when the request is unauthenticated. limit must be between 1 and 100, and offset must be zero or greater. status must be open or closed when provided.