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 ground rules

True of every call.

AuthenticationA bearer API key on every request
Sandbox or liveThe key decides: rhq_test_ or rhq_live_
Retrying a purchaseSend an Idempotency-Key and it never buys twice
Rate limit300 requests a minute per key, 20 at once
Webhook signaturesHMAC-SHA256 in the webhook-signature header
Webhook retriesSeven retries over about 32 hours, then resend by hand

Webhooks for everything

Over 60 events, signed and retried. A few of them:

Every event

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.

SandboxLive
API keys start withrhq_test_rhq_live_
Orders are filled byA built-in test providerReal providers
WalletTest funds you add yourselfReal funds
Numbers, domains, mailboxesNot realReal
WebhooksReal, signed, deliveredReal, signed, delivered

Start here

The guides developers open first.

Start selling under your own brand

  1. Sign up with an email, no call needed1 minute
  2. Get test keys and $5,000 of pretend moneyInstantly
  3. Take order #0001 under your own nameToday