GET
/
verify
/
v1
/
email
curl --request GET \
  --url https://api.customeros.ai/verify/v1/email \
  --header 'X-CUSTOMER-OS-API-KEY: <api-key>'
{
  "email": {
    "alternateEmail": "alternate@example.com",
    "deliverable": "true",
    "emailAddress": "example@example.com",
    "isCatchAll": false,
    "isRisky": false,
    "provider": "gmail",
    "risk": {
      "isFirewalled": false,
      "isFreeProvider": true,
      "isMailboxFull": false,
      "isPrimaryDomain": true,
      "isRoleMailbox": false,
      "isSystemGenerated": false
    },
    "secureGatewayProvider": "Proofpoint",
    "syntax": {
      "domain": "example.com",
      "isValid": true,
      "user": "example"
    }
  },
  "requestId": "1234567890abcdef",
  "status": "success"
}

Authorizations

​
X-CUSTOMER-OS-API-KEY
string
header
required

Query Parameters

​
address
string
required

Email address to verify

​
verifyCatchAll
boolean
default:true

Verify catch-all domain

Response

200
application/json
Email verification results

Response for single email verification including detailed validation results

​
email
object

Email verification details required: true

​
requestId
string
Example:

"1234567890abcdef"

​
status
string

Status indicates the result of the operation ("success" or "error")

Example:

"success"

Upload emails for bulk verification