List inboxes

GET/v1/inboxes

Returns your inboxes, newest first. Filter by domain, status or tenant.

Query and path parameters

domainstring: Only inboxes on this domain.
statusstring: warming, ready, paused or held.
pageinteger: Which page of results, from 1.
per_pageinteger: Up to 100. Defaults to 25.

curl https://api.mailyard.com/v1/inboxes \
  -H "Authorization: Bearer $MAILYARD_KEY"

Response200 OK

{
  "data": [
    { "id": "inb_8f2k1q", "address": "maya.chen@getacme.co", "status": "ready" }
  ],
  "links": { "next": "https://api.mailyard.com/v1/inboxes?page=2", … },
  "meta": { "current_page": 1, "per_page": 25, "total": 1248 }
}