Get Managed Mailbox Config

Available mailbox platforms, prices and order limits.

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

Requires an API key with the read scope.

Response#

dataobject

Configuration.

Show data

platformsarray

Platforms you can order.

Show platforms

idstring

GOOGLE or MICROSOFT.

labelstring

Google Workspace or Microsoft 365.

monthlyCentsinteger

Monthly price per mailbox in US cents.

maxMailboxesPerDomaininteger

Mailboxes allowed on one domain.

maxDomainsPerOrderinteger

Domains allowed in one order.

registrationYearsinteger

Years a new domain is registered for.

defaultDailyLimitinteger

Daily sending limit new mailboxes start with.

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/config" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
config = client.managed_inboxes.config()

import { FoxReach } from "foxreach";

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

Response

{
  "data": {
    "platforms": [
      { "id": "GOOGLE", "label": "Google Workspace", "monthlyCents": 400 },
      { "id": "MICROSOFT", "label": "Microsoft 365", "monthlyCents": 400 }
    ],
    "maxMailboxesPerDomain": 5,
    "maxDomainsPerOrder": 10,
    "registrationYears": 1,
    "defaultDailyLimit": 30
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026