Mailactor
API reference

Export an inbox

Required scope: mailbox:read.

GET/v1/inboxes/{inboxId}/export

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

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/export" \  -H "x-api-key: $MAILACTOR_API_KEY"

Response examples

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

HTTP 200

{
  "formatVersion": 1,
  "inbox": {
    "id": "inb_0123456789abcdef01234567",
    "localPart": "research-agent",
    "domainId": null,
    "domainKind": "managed",
    "domain": "inbox.mailactor.com",
    "address": "research-agent@inbox.mailactor.com",
    "displayName": "Research Agent",
    "status": "active",
    "createdAt": "2026-09-08T12:00:00.000Z",
    "updatedAt": "2026-09-08T12:00:00.000Z"
  },
  "messages": [
    {
      "id": "msg_0123456789abcdef01234567",
      "inboxId": "inb_0123456789abcdef01234567",
      "threadId": "thr_0123456789abcdef01234567",
      "direction": "inbound",
      "internetMessageId": "<alex-reply@example.com>",
      "inReplyTo": "<research-42@inbox.mailactor.com>",
      "references": [
        "<research-42@inbox.mailactor.com>"
      ],
      "from": {
        "email": "you@example.com",
        "name": "Alex"
      },
      "to": [
        {
          "email": "research-agent@inbox.mailactor.com",
          "name": "Research Agent"
        }
      ],
      "subject": "Re: Your research update",
      "text": "Please send the summary.",
      "metadata": {},
      "delivery": {
        "submissionId": null,
        "status": "received",
        "failureCode": null
      },
      "createdAt": "2026-09-08T12:01:00.000Z",
      "updatedAt": "2026-09-08T12:01:00.000Z",
      "attachments": [],
      "inboundSecurity": {
        "trust": "untrusted",
        "smtp": {
          "remoteIp": "192.0.2.25",
          "helo": "mx.example.com",
          "tls": {
            "encrypted": true,
            "protocol": "TLSv1.3",
            "cipher": "TLS_AES_256_GCM_SHA384"
          }
        },
        "authentication": {
          "spf": "not_evaluated",
          "dkim": "not_evaluated",
          "dmarc": "not_evaluated"
        },
        "attachments": "unscanned"
      }
    },
    {
      "id": "msg_1123456789abcdef01234567",
      "inboxId": "inb_0123456789abcdef01234567",
      "threadId": "thr_0123456789abcdef01234567",
      "direction": "outbound",
      "internetMessageId": "<research-42@inbox.mailactor.com>",
      "inReplyTo": null,
      "references": [],
      "from": {
        "email": "research-agent@inbox.mailactor.com",
        "name": "Research Agent"
      },
      "to": [
        {
          "email": "you@example.com",
          "name": "Alex"
        }
      ],
      "subject": "Your research update",
      "text": "The research is ready for your review.",
      "html": "<p>The research is ready for your review.</p>",
      "replyTo": {
        "email": "research-agent@inbox.mailactor.com",
        "name": "Research Agent"
      },
      "metadata": {
        "taskId": "research-42"
      },
      "delivery": {
        "submissionId": "00000000-0000-4000-8000-000000000001",
        "status": "submitted",
        "failureCode": null
      },
      "createdAt": "2026-09-08T12:00:00.000Z",
      "updatedAt": "2026-09-08T12:00:00.000Z"
    }
  ],
  "nextCursor": null
}