List Managed Mailboxes

Every managed mailbox in the workspace.

GEThttps://api.foxreach.io/api/v1/managed-inboxes/mailboxes

Requires an API key with the read scope.

A flat list across all orders, oldest first. There is no pagination.

Response#

dataobject

Result.

Show data

itemsarray

Mailboxes.

Show items

idstring

Mailbox identifier.

emailstring

Mailbox address.

firstNamestring

First name on the mailbox.

lastNamestring

Last name on the mailbox.

platformstring

GOOGLE or MICROSOFT.

statusstring

Provisioning status of the mailbox.

connectStatestring

pending, connected, failed or detached.

emailAccountIdstring

The connected email account in FoxReach, or null until connected.

monthlyCentsinteger

Monthly price in US cents.

failureMessagestring

Why provisioning failed, or null.

lastConnectErrorstring

Last error while connecting the mailbox, or null.

connectedAtstring

ISO 8601 timestamp, or null.

cancelledAtstring

ISO 8601 timestamp, or null.

orderIdstring

The order the mailbox belongs to.

domainNamestring

The mailbox's domain.

Errors#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`
`404`	Not found while managed mailboxes are switched off on this environment (`{"detail": "Not found"}`)

Rate Limit#

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/managed-inboxes/mailboxes" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
mailboxes = client.managed_inboxes.list_mailboxes()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const mailboxes = await client.managedInboxes.listMailboxes();

Response

{
  "data": {
    "items": [
      {
        "id": "mbx_abc123",
        "email": "jane@yourbrand-mail.com",
        "firstName": "Jane",
        "lastName": "Doe",
        "platform": "GOOGLE",
        "status": "active",
        "connectState": "connected",
        "emailAccountId": "cea_abc123",
        "monthlyCents": 400,
        "failureMessage": null,
        "lastConnectError": null,
        "connectedAt": "2026-10-20T09:45:00+00:00",
        "cancelledAt": null,
        "orderId": "ord_abc123",
        "domainName": "yourbrand-mail.com"
      }
    ]
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026