List free email provider domains · Email API
Page through the 4,768 free email provider domains (the list HubSpot forms block with "Block free email providers", snapshot 2026-10-10), sorted alphabetically. Filter with `q` or sync the whole list with `limit=1000` to block free providers in your own code. Costs 0 credits.
Try it without an API key: Free email domain checker — business vs. personal.
curl https://api.unifapi.com/email/free-domains \ -H "Authorization: Bearer $UNIFAPI_KEY"
Parameters
- qquery
- Only return domains containing this text, e.g. `hotmail`.
- cursorquery
- Zero-based offset cursor returned as `next_cursor`.
- limitquery
- The limit query parameter for this Email operation. Use the URL-visible slug or id described in the docs.
- The parameter for this Email operation. Use the URL-visible slug or id described in the docs.
This operation is part of the Email API in the email category. It uses the same Bearer token, request tracing, error model, and billing envelope as every UnifAPI endpoint, so agents can switch between platforms without custom per-vendor glue code.
Use it when a workflow needs Email public data but should still keep one API key, one account balance, and one predictable JSON contract across social, live public-data sources.
Common agent workflows
- Look up public Email data for agents that need reliable open-web context.
- Give an AI agent a stable Email data source without building a per-platform integration.
- Normalize Email responses into the same UnifAPI envelope used across the catalog.
Unified envelope, platform-native fields
- List-style responses return `data` as an array of top-level records plus optional `pagination` for continuation tokens or cursors.
- This operation has a zero-credit multiplier, so successful responses include zero-charge billing metadata.
- If the workspace balance cannot cover every result, the response can be truncated and `billing.truncated_due_to_balance` tells the caller why.
Response status codes
Billing
This operation is free: it has a zero-credit multiplier and still returns billing metadata with zero credits charged.
Errors and retries
Authentication, validation, rate-limit, not-found, and provider errors use the unified UnifAPI error format. Agents should log `request_id`, retry only retryable failures, and treat invalid API keys, disabled keys, and expired keys as the same public `unauthorized` error type.
Agents & Skills built on Email
You rarely call List free email provider domains by hand. These prebuilt agents and skills already read Email data inside Claude or Codex — start from one of them, or call this endpoint yourself.
More Email operations
Combine endpoints from the same platform, then join the results with other UnifAPI categories without changing authentication or response parsing.
Check if an email uses a free provider
Classify one email address as `business`, `free`, or `invalid`. The domain is matched exactly against 4,768 free email provider domains (the list HubSpot forms block with "Block free email providers", snapshot 2026-10-10); the response also flags role mailboxes (info@, sales@, noreply@) and explains syntax failures. Runs without DNS or SMTP probes, so it is instant and costs 0 credits. Use it to gate signup and lead forms on work emails.
Check up to 1,000 emails for free providers
Classify up to 1,000 email addresses in one call, in input order, plus verdict counts. Each address gets the same checks as `GET /email/check`: exact match against 4,768 free email provider domains (the list HubSpot forms block with "Block free email providers", snapshot 2026-10-10), role-mailbox detection, and a syntax check. Use it to split a lead list or CRM export into business and personal addresses. Costs 0 credits.
Check if a domain is a free email provider
Classify a bare domain as `free`, `business`, or `invalid` against 4,768 free email provider domains (the list HubSpot forms block with "Block free email providers", snapshot 2026-10-10). Matching is exact: subdomains of a listed domain are not treated as free. A pasted address or website URL is reduced to its domain first. Costs 0 credits.