List available platform domains

View as Markdown
Returns the **platform-managed** domains available for inbox creation, filtered by your plan: - **Free / Developer / Startup** — free-tier domains only. - **Growth / Enterprise** — free-tier + pro-tier domains. Results are cached for up to 5 minutes. New domains appear automatically without requiring a code change on your side. Tags on each domain: - `new` — recently added domain, shown for ~30 days. - `popular` — high-traffic domain. Domains expiring within 30 days include `expires_at` and `expires_in_days` as a heads-up to migrate inboxes. Healthy domains omit these fields entirely to keep the payload lean. > **Custom domains** (domains you own and verified) are managed via > `GET /v1/custom-domains` — this endpoint only returns platform domains.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

OK
successboolean
countinteger
notestring
datalist of objects

Errors

401
Unauthorized Error
429
Too Many Requests Error