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
          • GETList all platform domains with full metadata
LogoLogo
FreeCustom.Email APIV1DomainsAll

List all platform domains with full metadata

||View as Markdown|
GET
https://api2.freecustom.email/v1/domains/all
GET
/v1/domains/all
$curl https://api2.freecustom.email/v1/domains/all \
>     -H "Authorization: Bearer <token>"
1{
2  "success": true,
3  "count": 10,
4  "data": [
5    {
6      "domain": "ditube.info",
7      "tier": "free",
8      "tags": [
9        "popular"
10      ],
11      "expires_at": "2026-08-01",
12      "expires_in_days": 147,
13      "expiring_soon": false,
14      "expired": false
15    },
16    {
17      "domain": "ditmail.pro",
18      "tier": "pro",
19      "tags": [
20        "new",
21        "featured"
22      ],
23      "expires_at": "2026-09-05",
24      "expires_in_days": 178,
25      "expiring_soon": false,
26      "expired": false
27    }
28  ]
29}
Same domain list as `GET /v1/domains` but always includes full expiry metadata for every domain — useful for dashboard integrations that monitor domain health or want to proactively alert users before a domain expires. Plan gating is identical: Growth / Enterprise see pro-tier domains, all other plans see free-tier only. > This endpoint covers **platform domains** only. For your own verified > custom domains use `GET /v1/custom-domains`.
Was this page helpful?
Previous

List available platform domains

Next

List your custom domains

Built with

Same domain list as GET /v1/domains but always includes full expiry metadata for every domain — useful for dashboard integrations that monitor domain health or want to proactively alert users before a domain expires.

Plan gating is identical: Growth / Enterprise see pro-tier domains, all other plans see free-tier only.

This endpoint covers platform domains only. For your own verified custom domains use GET /v1/custom-domains.

Authentication

AuthorizationBearer

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

Response

OK
successboolean
countinteger
datalist of objects

Errors

401
Unauthorized Error
429
Too Many Requests Error