Developers
One API for numbers, domains and mailboxes
Everything the dashboard does is a REST call or an MCP tool. Build against the sandbox, then swap the key to go live; the endpoints don’t change.
The API
What you can call
Phone numbers
Rent United States numbers, read every text they receive, renew or cancel.
- GET/v1/numbers/options
- PATCH/v1/numbers/{id}
- POST/v1/numbers/{id}/renew
- POST/v1/numbers/{id}/cancel
Domains
Search, register and renew, and run DNS, nameservers and transfers.
- PATCH/v1/domains/{id}
- GET/v1/domains/renewal-forecast
Google mailboxes
Add a domain, order mailboxes on it one at a time or in bulk, and keep its DNS healthy.
- GET/v1/mailboxes/price
- POST/v1/mailbox-domains
- POST/v1/mailboxes/bulk
- POST/v1/mailbox-domains/{id}/dns/check
Wallet
Top up, and read every movement: top-ups, charges, refunds.
- POST/v1/wallet/top-ups
- GET/v1/wallet/transactions
Account and activity
What the calling key can order, and a log of everything that changed.
- GET/v1/account
- GET/v1/activity
MCP server
The same operations as tools for AI agents, behind keys that read, manage, or also buy.
The ground rules
True of every call.
| Authentication | A bearer API key on every request |
|---|---|
| Sandbox or live | The key decides: rhq_test_ or rhq_live_ |
| Retrying a purchase | Send an Idempotency-Key and it never buys twice |
| Rate limit | 300 requests a minute per key, 20 at once |
| Webhook signatures | HMAC-SHA256 in the webhook-signature header |
| Webhook retries | Seven retries over about 32 hours, then resend by hand |
Numbers
- number.message.received
- number.order.completed
- number.rental.renewed
- number.rental.expired
Mailboxes
- mailbox.setup_progress
- mailbox.active
- mailbox_domain.active
- mailbox_domain.dns_broken
Domains
- domain.registered
- domain.renewed
- domain.expiring
- domain.transfer.completed
Money and your store
- wallet.topped_up
- invoice.paid
- credit_note.issued
- sale.below_cost
- portal.order.placed
Sandbox and live
Two sides of one account, kept apart in every way that matters.
| Sandbox | Live | |
|---|---|---|
| API keys start with | rhq_test_ | rhq_live_ |
| Orders are filled by | A built-in test provider | Real providers |
| Wallet | Test funds you add yourself | Real funds |
| Numbers, domains, mailboxes | Not real | Real |
| Webhooks | Real, signed, delivered | Real, signed, delivered |
Start here
The guides developers open first.
Quickstart
From test keys to your first order.
API reference
Every endpoint, request and error.
Webhooks
Signed, timestamped and retried until you answer.
Idempotency
Retry any purchase without buying twice.
Errors and limits
Every error code and what to do.
Start selling under your own brand
- Sign up with an email, no call needed1 minute
- Get test keys and $5,000 of pretend moneyInstantly
- Take order #0001 under your own nameToday