Skip to main content
GET

Overview

The Email Verification API validates email syntax, queries receiving mail exchangers, and returns detailed deliverability signals—including mailbox existence, deliverable/undeliverable verdicts, catch-all server detection, and reason codes. This endpoint supports GET requests authenticated with your ProWebLook API key.

Request Parameters

string
required
Your ProWebLook API key. See Authentication.
string
required
The email address to verify (e.g. [email protected]).

Response Fields

integer
Current remaining email credits after the check or refund attempt. Omitted when API authentication fails.
boolean
true for a completed check; false for authentication, credit, or provider lookup failure.
string
The email address that was checked.
boolean
true if the email address follows valid RFC syntax; false if malformed.
boolean
true if the mailbox exists (deliverable or catch-all server); false if undeliverable.
string
Deliverability verdict: deliverable, undeliverable, unknown, or invalid_format.
string
Specific reason code: mailbox_accepted, mailbox_not_found, catch_all, invalid_syntax, network_timeout, etc.
string
Human-readable error description when status is false.

Credit Cost & Refunds

  • 1 email credit is deducted for each completed check (including invalid syntax or undeliverable addresses).
  • If upstream verification times out or fails to return a conclusive answer, the API returns HTTP 200 with status: false, and automatically refunds the reserved credit to your balance.