Skip to main content
GET
List emails, optionally waiting for new mail

Authorizations

Authorization
string
header
required

Authorization: Bearer mm_.... Omit entirely to use the anonymous tier.

Path Parameters

address
string
required

Full inbox address, URL-encoded. Case-insensitive.

Example:

"abc123@meowmail.in"

Query Parameters

limit
integer
default:25
Required range: 1 <= x <= 100
since
string

Return only emails newer than this id. Flips ordering to oldest-first.

before
string

Return only emails older than this id. Pages backwards.

wait
integer
default:0

Seconds to hold the connection if the result would be empty. Requires an API key. Set your HTTP client timeout above this value.

Required range: 0 <= x <= 30

Response

Email summaries. An empty array means no mail matched (including after a wait timed out).

data
object[]
meta
object