---
title: "List mailboxes"
method: GET
path: "/api/v1/inboxes"
tags: ["Mailboxes"]
---

# List mailboxes

`GET /api/v1/inboxes`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/inboxes`
- Auth: HTTP bearer

The mailboxes connected to your workspace (Google, Microsoft and any other provider), with state, health and today's sends against the daily limit, and what needs fixing. No passwords or tokens are ever returned.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts` |

## Query parameters

- `limit` integer
- `cursor` string
- `offset` integer

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `total` integer, nullable, required: How many rows exist in total for this query.
  - `limit` integer, required: Rows per page in this answer.
  - `offset` integer, required: Rows skipped before this page.
  - `next_cursor` string, nullable, required: Pass as cursor to get the next page. null on the last page.
  - `has_more` boolean, required: true when another page exists.
  - `total_is_estimate` boolean: Present and true when total is a lower bound, for example when a list reached its upper size.
  - `inboxes` Mailbox[], required
    - `email` string, email: Mailbox address.
    - `name` string, nullable: Display name.
    - `provider` string: google, ms365 or smtp.
    - `status` string: Connection state.
    - `health` string: Sending health.
    - `daily_limit` integer, nullable: Cold emails a day.
    - `sent_today` integer, nullable: Sent today.
    - `needs_attention` boolean: true when something needs fixing.
    - `attention` string, nullable: What needs fixing, in plain words.

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)