Platform domains

Platform domains are managed by FreeCustom.Email and shared across all users. Results are plan-gated and Redis-cached with a 5-minute TTL — new domains appear automatically without a code change on your side.

Looking to use your own domain? See Custom domains.

Plan gating

The domain list returned depends on your API plan:

Plan	Domains visible
Free / Developer / Startup	Free-tier domains only
Growth / Enterprise	Free-tier + pro-tier domains

GET /v1/domains

Returns the domains available for inbox creation on your plan. Domains expiring within 30 days include expires_at and expires_in_days as a nudge to migrate; healthy domains omit these fields to keep the payload lean.

curl

curl "https://api2.freecustom.email/v1/domains" \
  -H "Authorization: Bearer fce_your_api_key"

Responses

200Success — Free / Developer / Startup

json

{
  "success": true,
  "count": 10,
  "note": "Upgrade to Growth plan to access additional pro domains.",
  "data": [
    { "domain": "ditube.info",  "tier": "free", "tags": ["popular"] },
    { "domain": "ditplay.info", "tier": "free", "tags": ["popular"] },
    { "domain": "ditapi.info",  "tier": "free", "tags": [] },
    {
      "domain": "getnotify.io",
      "tier": "free",
      "tags": ["new"],
      "expires_at": "2026-04-01",
      "expires_in_days": 25,
      "expiring_soon": true
    }
  ]
}

200Success — Growth / Enterprise

json

{
  "success": true,
  "count": 14,
  "note": "Growth/Enterprise plan: free + pro domains included.",
  "data": [
    { "domain": "ditube.info",  "tier": "free", "tags": ["popular"] },
    { "domain": "ditmail.pro",  "tier": "pro",  "tags": ["new", "featured"] },
    { "domain": "mock-api.pro", "tier": "pro",  "tags": ["new", "featured"] }
  ]
}

GET /v1/domains/all

Same list as GET /v1/domains but always includes full expiry metadata on every entry — useful for dashboard integrations that monitor domain health.

curl

curl "https://api2.freecustom.email/v1/domains/all" \
  -H "Authorization: Bearer fce_your_api_key"

Responses

200Success

json

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