List all platform domains with full metadata | freecustom-email

import requests
url = "https://api2.freecustom.email/v1/domains/all"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "tags": [
        "popular"
      ],
      "tier": "free",
      "domain": "ditube.info",
      "expired": false,
      "expires_at": "2026-08-01",
      "expiring_soon": false,
      "expires_in_days": 147
    },
    {
      "tags": [
        "new",
        "featured"
      ],
      "tier": "pro",
      "domain": "ditmail.pro",
      "expired": false,
      "expires_at": "2026-09-05",
      "expiring_soon": false,
      "expires_in_days": 178
    }
  ],
  "count": 10,
  "success": true
}

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.

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

datalist of objects

countinteger

successboolean

Errors

401

Unauthorized Error

429

Too Many Requests Error