Skip to content

Get one received email​

GET
/v1/aliases/{alias}/messages/{messageId}

One parsed inbound email — headers, body, per-field SPF/DKIM/DMARC + spam/virus verdicts, and attachment metadata.

Authorizations​

apiKey

Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters​

Path Parameters

alias*

The alias id (al_…, URL-safe — preferred) or its full address (percent-encode the @).

Type
string
Required
Example"al_01KXBRV8HB64MA2H6QM49B2V8F"
messageId*

The message's id (evt_…, URL-safe — preferred) or its RFC Message-ID (percent-encoded).

Type
string
Required
Example"evt_01M50GHMJRP15Z4602V9XFVKDA"

Responses​

The message.

application/json
JSON
{
  
"id": "evt_01M50GHMJRP15Z4602V9XFVKDA",
  
"message_id": "<abc@buyer.com>",
  
"event_id": "string",
  
"alias": "support",
  
"from": "jane@buyer.com",
  
"to": [
  
  
"string"
  
],
  
"cc": [
  
  
"string"
  
],
  
"subject": "string",
  
"received_at": "string",
  
"date": "string",
  
"text": "string",
  
"html": "string",
  
"size_bytes": 0,
  
"headers": {
  
  
"additionalProperties": "string"
  
},
  
"verdicts": {
  
  
"spf": "string",
  
  
"dkim": "string",
  
  
"dmarc": "string",
  
  
"spam": "string",
  
  
"virus": "string",
  
  
"dmarc_policy": "string"
  
},
  
"status": "string",
  
"auth": "string",
  
"endpoint_id": "string",
  
"attachments": [
  
  
{
  
  
  
"id": "att_01M50GHMJRP15Z4602V9XFVKDA_0",
  
  
  
"name": "INV-2291.pdf",
  
  
  
"size": 182340,
  
  
  
"content_type": "application/pdf",
  
  
  
"content_id": "ii_mgb3k9x10",
  
  
  
"disposition": "string"
  
  
}
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Emithook · a Finnoto product