For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • FreeCustom.Email API
        • GETList available platform domains
LogoLogo
FreeCustom.Email APIV1Domains

List available platform domains

||View as Markdown|
GET
https://api2.freecustom.email/v1/domains
GET
/v1/domains
$curl https://api2.freecustom.email/v1/domains \
>     -H "Authorization: Bearer <token>"
1{
2  "success": true,
3  "count": 10,
4  "note": "Upgrade to Growth plan to access additional pro domains.",
5  "data": [
6    {
7      "domain": "ditube.info",
8      "tier": "free",
9      "tags": [
10        "popular"
11      ]
12    },
13    {
14      "domain": "ditplay.info",
15      "tier": "free",
16      "tags": [
17        "popular"
18      ]
19    },
20    {
21      "domain": "ditapi.info",
22      "tier": "free",
23      "tags": []
24    },
25    {
26      "domain": "getnotify.io",
27      "tier": "free",
28      "tags": [
29        "new"
30      ],
31      "expires_at": "2026-04-01",
32      "expires_in_days": 25,
33      "expiring_soon": true
34    }
35  ]
36}
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.
Was this page helpful?
Previous

List plans and credit packages

Next

List all platform domains with full metadata

Built with

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