List Inboxes
List test inboxes owned by the account.
List test inboxes owned by the account.
Scope: email_testing.inboxes.read
Query Parameters
qstringoptionalOnly return inboxes whose address contains this text (not case-sensitive). Up to 200 characters.
kindstringoptionalOnly return inboxes of this kind: permanent, ephemeral (expires automatically), or invisible (hidden from the default list).
include_invisiblebooleanoptionalAlso return invisible inboxes, which are hidden by default. Useful for finding inboxes your tests created.
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
Request
curl "https://api.maileroo.com/v1/email-testing/mailboxes" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Sample Response
The response is wrapped in a data object.
Response
{
"data": {
"mailboxes": [
{
"id": "35a3cb89-ea59-4ea3-8edc-a5c5f7bf0bda",
"account_id": "12345",
"domain_id": "sandbox",
"local_part": "inbox",
"address": "[email protected]",
"kind": "permanent",
"smtp_response": "accept",
"invisible": false,
"expires_at": null,
"created_at": "2025-01-01T12:00:00Z"
}
],
"next_cursor": ""
}
}Errors
400 Bad Request— invalid pagination or query parameters.