GET
/
mailboxes
curl --request GET \
  --url https://api.amplemarket.com/mailboxes \
  --header 'Authorization: Bearer <token>'
{
  "mailboxes": [
    {
      "id": "0197c138-8b2e-7888-8ae2-05e16faf50a4",
      "email": "mailbox@example.com",
      "email_provider": "google",
      "daily_email_limit": 50,
      "status": "active",
      "user": {
        "id": "0197c138-8b05-7b05-9ead-fd21290d1a08",
        "name": "Example User",
        "email": "foo-21@email.com"
      },
      "created_at": "2025-06-30T14:23:17Z",
      "updated_at": "2025-06-30T14:23:17Z"
    }
  ],
  "_links": {
    "self": {
      "href": "/mailboxes?page[size]=20"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page[size]
string

Page size (max 20)

​
page[after]
string

Page after

​
page[before]
string

Page before

​
status
enum<string>

Filter by mailbox status

Available options:
active,
inactive,
needs_reconnection
​
email_provider
enum<string>

Filter by email provider

Available options:
google,
outlook,
other,
other_mixed
​
user_email
string

Filter by user email

Response

200 - application/json

Successful

The response is of type object.