API referenceMessages
Get message detail
GET
bearerAuthheader
AuthorizationBearer <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.
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?stringValue in
"queued""sent""failed""suppressed""scheduled""cancelled"ses_message_id?string|nullerror?string|nullcreated_at?integerFormat
int64updated_at?integerFormat
int64curl -X GET "https://example.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}