Mailactor
API reference

List conversations

Required scope: mailbox:read.

GET/v1/inboxes/{inboxId}/threads

Authorization

tenantApiKey
x-api-key<token>

A scoped tenant key returned once by an operator. Never place it in URLs, logs, prompts, or client-side application code.

In: header

Path Parameters

inboxId*string
Match^inb_[a-f0-9]{24}$

Query Parameters

limit?integer
Range1 <= value <= 100
cursor?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

# Set the API key and replace resource IDs with your saved IDs.curl --fail-with-body --silent --show-error -X GET \  "https://api.mailactor.com/v1/inboxes/$INBOX_ID/threads" \  -H "x-api-key: $MAILACTOR_API_KEY"

Response examples

Illustrative values; save the IDs and limits returned by your own requests.

HTTP 200

{
  "threads": [
    {
      "id": "thr_0123456789abcdef01234567",
      "inboxId": "inb_0123456789abcdef01234567",
      "subject": "Your research update",
      "participants": [
        "research-agent@inbox.mailactor.com",
        "you@example.com"
      ],
      "messageCount": 2,
      "lastMessageAt": "2026-09-08T12:01:00.000Z"
    }
  ],
  "nextCursor": null
}