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.

Email Address Validation

get

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

Path parameters

workspaceIdstringRequired

Workspace ID

addressstringRequired

Email address to validate

Example: [e-mail]

Responses

200

Success

application/json

get

HTTPcURLJavaScriptPython

GET /api/workspaces/{workspaceId}/reach/v1/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
  }
}