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.
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
Responses
200
Success
application/json
get
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
}
}
Was this helpful?