List threads
Returns a paginated list of conversation threads for the given inbox, ordered by most recent activity.
Authorization
BearerAuth AuthorizationBearer <token>
API key passed as a Bearer token. Production keys start with
am_live_ and sandbox keys start with am_test_.
In: header
Path Parameters
slug*string
The unique slug identifier of the inbox.
Query Parameters
limit?integer
Maximum number of items to return per page.
Default
25Range
1 <= value <= 100cursor?string
Opaque pagination cursor returned as next_cursor from a previous request.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://secureagentmail.com/api/v1/inboxes/string/threads"{
"threads": [
{
"id": "thr_p4q8r1",
"inbox_id": "inb_abc123",
"subject": "Need help with billing",
"message_count": 5,
"last_message_at": "2026-02-25T14:30:00Z",
"created_at": "2026-02-20T09:00:00Z"
}
],
"has_more": true,
"next_cursor": "string"
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key.",
"status": 401
}
}{
"error": {
"code": "not_found",
"message": "The requested resource was not found.",
"status": 404
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Please retry after 30 seconds.",
"status": 429
}
}