Skip to content

List received emails for an alias​

GET
/v1/aliases/{alias}/messages

Inbound email parsed by the MX engine, with parsed fields and attachment links.

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"

Query Parameters

cursor

Opaque pagination cursor; pass back next_cursor from the previous page.

Type
string

Responses​

A page of messages.

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"id": "evt_01M50GHMJRP15Z4602V9XFVKDA",
  
  
  
"message_id": "string",
  
  
  
"from": "jane@buyer.com",
  
  
  
"subject": "string",
  
  
  
"received_at": "string",
  
  
  
"auth": "string"
  
  
}
  
],
  
"next_cursor": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Emithook · a Finnoto product