Get message detail
bearerAuthAuthorizationBearer <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.
id*stringThe message id returned by POST /v1/email(/batch).
Message detail, with its delivery timeline.
application/json- 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?stringfrom_addr?stringto_addr?stringThe primary (first to) recipient only — the full recipient set is not stored.
subject?stringstatus?string"queued""sent""failed""suppressed""scheduled""cancelled""pending_approval"ses_message_id?string|nullerror?|Why it failed or was cancelled — for a held send that never went out, approval_rejected or approval_expired.
created_at?integerint64updated_at?integerint64source?|mcp when an AI agent sent it through the MCP endpoint; null for the REST API.
"mcp"nullagent?|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?
curl -X GET 'https://api.emitd.com/v1/messages/string'{ "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" }}