Validation

Validate an email address

Groundmail validation for one address, for example on a signup form: syntax, whether the domain can receive email, disposable and role addresses, recent hard bounces across Groundmail, and a typo suggestion for common mailbox providers. Free, and nothing is sent to the address. Rate limit: 120 requests a minute and 5,000 an hour per API key.

post/validate

Request

  • Base URL: https://api.groundmail.dev
  • URL: https://api.groundmail.dev/validate
  • Auth: HTTP bearer

Request body

emailstring required

Example request

{
  "email": "ada@gmial.com"
}

Response

Verdict for the address

emailstring required

The address as checked (trimmed, lowercased)

domainstring nullable required
verdict'valid' | 'risky' | 'invalid' required

valid: nothing wrong found. risky: can probably receive email but deserves a second look (disposable, catch-all, likely typo). invalid: cannot receive email.

reasonsstring[] required

What was found. Invalid: syntax, no_mail_server, mailbox_not_found, previously_bounced. Risky: disposable, catch_all, possible_typo. Informational (does not change the verdict): role.

suggestionstring nullable required

The address with a likely-mistyped domain corrected, or null

disposableboolean required

A throwaway-inbox service

roleboolean required

A team or queue mailbox such as info@ or support@

Example response

{
  "suggestion": "ada@gmail.com"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.