List Messages
List captured messages, optionally filtered by mailbox, sender, recipient, or subject.
List captured messages, optionally filtered by mailbox, sender, recipient, or subject.
Scope: email_testing.messages.read
Query Parameters
mailbox_idstringoptionalOnly include messages captured by this test inbox.
credential_idstringoptionalOnly include messages sent through this SMTP sink credential.
recipientstringoptionalOnly match messages sent to exactly this recipient address.
senderstringoptionalOnly match messages from exactly this sender address.
recipient_containsstringoptionalOnly match messages whose recipient address contains this text.
sender_containsstringoptionalOnly match messages whose sender address contains this text, for example @example.com.
subject_containsstringoptionalOnly match messages whose subject contains this text.
limitintegeroptionalHow many results to return per page. Defaults to 50, and at most 200 are returned.
cursorstringoptionalWhere to continue from. Pass the next_cursor value from the previous page; leave it out to start at the first page. An empty next_cursor means there are no more results.
Sample Request
curl "https://api.maileroo.com/v1/email-testing/messages" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Sample Response
The response is wrapped in a data object.
{
"data": {
"messages": [
{
"id": "d5949378-3069-4d8f-a8f3-6e5edf5d6060",
"mailbox_id": "35a3cb89-ea59-4ea3-8edc-a5c5f7bf0bda",
"subject": "Welcome",
"from": "[email protected]",
"to": "[email protected]",
"analysis_status": "ready",
"preview_status": "ready",
"size_bytes": 1842,
"received_at": "2025-01-01T12:00:00Z"
}
],
"next_cursor": ""
}
}Errors
400 Bad Request— invalid pagination or query parameters.