Mailactor
API reference

Get a submission

Required scope: delivery:read.

GET/v1/submissions/{submissionId}

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

submissionId*string
Formatuuid

Response Body

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

Response examples

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

HTTP 200

{
  "id": "00000000-0000-4000-8000-000000000001",
  "from": {
    "email": "research-agent@inbox.mailactor.com",
    "name": "Research Agent"
  },
  "recipients": [
    {
      "email": "you@example.com",
      "status": "delivered",
      "response": "250 2.0.0 Message accepted",
      "updatedAt": "2026-09-08T12:01:00.000Z"
    }
  ],
  "subject": "Your research update",
  "metadata": {
    "taskId": "research-42"
  },
  "status": "delivered",
  "queueId": "mailactor-example-queue",
  "response": "250 2.0.0 Message accepted",
  "failureCode": null,
  "createdAt": "2026-09-08T12:00:00.000Z",
  "updatedAt": "2026-09-08T12:01:00.000Z"
}