Recipient Validation

Recipient Validation is an easy, efficient way to verify that email addresses are valid before you send. It runs addresses through a series of checks that catch many common problems, including syntax issues and non-existent mailboxes.

Learn more about the different response fields and read how to integrate Recipient Validation into your forms.

Regional Endpoints

Please use the appropriate API endpoint based on your workspace region:

• EU workspaces: https://email.eu-west-1.api.bird.com

• US workspaces: https://email.us-west-2.api.bird.com

Email Address Validation

get

https://email.eu-west-1.api.bird.com/apihttps://email.us-west-2.api.bird.com/api

/workspaces/{workspaceId}/reach/recipient-validation/single/{address}

Validate a single email address. The response will contain whether the address is valid, neutral, risky, undeliverable or typo along with additional metadata about the address. If the email address is undeliverable, a reason will also be provided. Use UTF-8 encoding for special characters like /.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key for authentication. Format: AccessKey <token> or Bearer <token>.

Path parameters

workspaceIdstringRequired

Workspace ID

addressstringRequired

Email address to validate

Example: [email protected]

Responses

200

Success

application/json

get

/workspaces/{workspaceId}/reach/recipient-validation/single/{address}

HTTPcURLJavaScriptPython

GET /api/workspaces/{workspaceId}/reach/recipient-validation/single/{address} HTTP/1.1
Host: email.eu-west-1.api.bird.com
Authorization: YOUR_API_KEY
Accept: */*

200

Success

{
  "results": {
    "result": "valid",
    "valid": true,
    "is_role": false,
    "is_disposable": false,
    "delivery_confidence": 85,
    "is_free": true
  }
}