Verify v1 · Email
Before calling these endpoints, use a Geoscape Hub application with access to this API product. Authenticate with your Consumer Key in the Authorization header. See Authentication, Error Handling, Rate Limiting, and Attribution for shared integration guidance.
Validate
Authentication: Use your Consumer Key in the
Authorizationheader.
Check one email address supplied in the JSON body.
validis true when syntax passes and the domain has usable MX records. It does not confirm mailbox existence- If syntax fails,
domainis omitted and no DNS check runs - Role, consumer-provider, and disposable-email flags do not change
valid - Unsupported body fields and query parameters return
400. A processed invalid address returns200
Requires paid-plan access. Each processed request costs 1 credit. See Interpreting Results for normalisation, categories, and DNS results.
Code
Validate › Request Body
emailEmail address to check. Surrounding whitespace is trimmed and the domain lowercased. The local part is preserved. Values within the request length limit can still fail syntax validation.
Validate › Responses
OK - the address was checked. A failed check is still a 200.
attributionData attribution notice.
requestTimeStampUnix timestamp in seconds for the response.
requestDateTimeUTC date and time for the request.
The request body echoed exactly as supplied.
validTrue only when syntax.valid and domain.has_mx are both true. Does not confirm mailbox existence. Category flags do not change this verdict.
Result of the syntax check, and the tidied form of the address that was validated. Always present.
Checks performed, credit cost, request ID, and processing time. Always present.
Domain lookup and category results. Omitted when syntax validation fails and no DNS lookup runs.