Unif API Docs

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.

Pricing — Free

This endpoint returns billing metadata with zero credits charged.

GET
/email/check

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

email*string

Email address to classify, e.g. jane@gmail.com.

Length1 <= length <= 512

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/email/check?email=string"
{  "request_id": "string",  "data": {    "input": "string",    "email": "string",    "local_part": "string",    "domain": "string",    "is_valid_syntax": true,    "is_free_provider": true,    "is_role_account": true,    "verdict": "business",    "invalid_reason": "empty"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}