Skip to Content
Docs

Get message detail

GET
/v1/messages/{id}

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Path Parameters

id*string

The message id returned by POST /v1/email(/batch).

Response Body

Message detail, with its delivery timeline.

application/json
  1. response

The exact row shape returned by GET /v1/messages(/{id}) — note the from_addr/to_addr field names (this endpoint's own local row type, distinct from the richer email_core::Message used internally; it does not include tenant_id, message_stream, tags, or scheduled_at).

id?string
from_addr?string
to_addr?string

The primary (first to) recipient only — the full recipient set is not stored.

subject?string
status?string
Value in"queued""sent""failed""suppressed""scheduled""cancelled""pending_approval"
ses_message_id?string|null
error?|

Why it failed or was cancelled — for a held send that never went out, approval_rejected or approval_expired.

created_at?integer
Formatint64
updated_at?integer
Formatint64
source?|

mcp when an AI agent sent it through the MCP endpoint; null for the REST API.

Value in"mcp"null
agent?|

The MCP client that sent it (name/version), when known.

events?array<>

Delivery timeline, oldest first (at most 200).

diagnosis?

Did this email arrive, and if not, why?

Example Request
curl -X GET 'https://api.emitd.com/v1/messages/string'
Example Response
{  "id": "string",  "from_addr": "string",  "to_addr": "string",  "subject": "string",  "status": "queued",  "ses_message_id": "string",  "error": "string",  "created_at": 0,  "updated_at": 0,  "source": "mcp",  "agent": "string",  "events": [    {      "type": "delivery",      "created_at": 0    }  ],  "diagnosis": {    "state": "delivered",    "summary": "string",    "next_step": "string"  }}