Validate Email

Verify whether an email address exists and is deliverable via real-time SMTP verification. Costs 0.25 credits for a valid result.

POST/v1/validate

Parameters

emailstring*

The email address to validate.

Request Example

cURL

curl -X POST https://api.gtmdata.co/v1/validate \
  -H "Authorization: Bearer gtm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email":"ceo@example.com"}'

Response Examples

Valid

{
  "email": "ceo@example.com",
  "status": "valid",
  "provider": "google"
}

Invalid

{
  "email": "nobody@example.com",
  "status": "invalid",
  "provider": "google"
}

Catch-All

{
  "email": "anything@catchall-corp.com",
  "status": "catchall",
  "provider": "other"
}

Response Fields

Field	Type	Description
`email`	string	The email address that was validated
`status`	string	Validation result: valid, invalid, catchall, valid_catchall, disposable, or risky
`provider`	string	Email provider: google, microsoft, other

Note: Only valid results are charged (0.25 credits). All other statuses are free.