Quote Order

Price an order without placing it.

POSThttps://api.foxreach.io/api/v1/managed-inboxes/orders/quote

Requires an API key with the read scope.

A quote never creates an order and never charges money, which is why it only needs the read scope. It checks every domain's live availability and rejects the order if one cannot be bought.

Body Parameters#

redirectUrlstringbodyrequired

Where the new domains forward to. Must be a full https:// address.

domainsarraybodyrequired

1 to 100 domain objects, within the limit from Get Managed Mailbox Config. Each has name (the domain), platform (GOOGLE or MICROSOFT) and mailboxes: 1 to 5 objects with firstName, lastName and username (lowercase letters, numbers, dots, dashes and underscores).

Response#

dataobject

The quote.

Show data

oneTimeCentsinteger

One-time cost in US cents (domain registration).

monthlyCentsinteger

Monthly cost in US cents (mailboxes).

registrationYearsinteger

Years each domain is registered for.

domainsarray

One line per domain.

Show domains

namestring

Domain.

platformstring

GOOGLE or MICROSOFT.

priceCentsinteger

Registration price in US cents.

renewalPriceCentsinteger

Renewal price in US cents.

mailboxCountinteger

Mailboxes on the domain.

monthlyCentsinteger

Monthly cost for the domain's mailboxes in US cents.

Errors#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`
`400`	The order is not valid. The message says what to change, for example `Enter a full https:// address for your website, like https://yourcompany.com`, `{name} is listed twice`, `Add at least one mailbox on {name}`, `Up to 5 mailboxes per domain` or that a domain is unavailable
`404`	Not found while managed mailboxes are switched off on this environment (`{"detail": "Not found"}`)
`422`	The body does not match the shape above
`502`	`Domain check is unavailable right now. Try again in a minute.` when the registrar lookup fails

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 POST "https://api.foxreach.io/api/v1/managed-inboxes/orders/quote" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "redirectUrl": "https://yourcompany.com",
    "domains": [
      {
        "name": "yourbrand-mail.com",
        "platform": "GOOGLE",
        "mailboxes": [{"firstName": "Jane", "lastName": "Doe", "username": "jane"}]
      }
    ]
  }'

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
quote = client.managed_inboxes.quote_order({
    "redirectUrl": "https://yourcompany.com",
    "domains": [{
        "name": "yourbrand-mail.com",
        "platform": "GOOGLE",
        "mailboxes": [{"firstName": "Jane", "lastName": "Doe", "username": "jane"}],
    }],
})

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const quote = await client.managedInboxes.quoteOrder({
  redirectUrl: "https://yourcompany.com",
  domains: [{
    name: "yourbrand-mail.com",
    platform: "GOOGLE",
    mailboxes: [{ firstName: "Jane", lastName: "Doe", username: "jane" }],
  }],
});

Response

{
  "data": {
    "oneTimeCents": 1400,
    "monthlyCents": 400,
    "domains": [
      {
        "name": "yourbrand-mail.com",
        "platform": "GOOGLE",
        "priceCents": 1400,
        "renewalPriceCents": 1800,
        "mailboxCount": 1,
        "monthlyCents": 400
      }
    ],
    "registrationYears": 1
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026