# List mailboxes (/api-reference/mailboxes/listMailboxes)

## List mailboxes

`GET https://app.alienmail.io/api/v1/mailboxes`

The mailboxes connected to your workspace, newest first. Passwords, tokens and server settings are never returned.

Requires the `SMTP_READ` permission.

Authentication: `Authorization: Bearer <your API key>`

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer | no | Items per page, 1 to 100. Default 25. A number outside that range is rounded to the nearest limit (`0` is 1, `500` is 100) and a fraction rounded down; anything that is not a number is the default. |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Anything else returns 400. |

### Responses

**200**: A page of mailboxes.

```json
{
  "data": [
    {
      "id": 7,
      "email": "ada@analyticalengines.com",
      "name": "Ada from Analytical Engines",
      "provider": "google",
      "active": true,
      "connected": true,
      "rateLimited": false,
      "dailyLimit": 50,
      "sentToday": 12,
      "createdAt": "2026-11-13T09:30:00.000Z",
      "updatedAt": "2026-11-13T09:30:00.000Z"
    }
  ],
  "nextCursor": null
}
```

**400**: The request is invalid: `fields` names the parameters to fix.

**401**: The API key is missing, wrong or revoked, its creator left the workspace or was suspended, or the workspace is archived or deleted.

**403**: The API key's role lacks the permission this endpoint needs.

**429**: More than 120 requests in a minute with this key, or a workspace limit on adding and removing leads.

Errors look like `{ "error": { "code": "not_found", "message": "Campaign not found" } }`. See the Errors page.