Verify Email Address

Legacy monolith path for email format and mailbox deliverability. Prefer GET https://lookup.proweblook.com/api/v1/emailvalidation for new integrations. A completed result uses status=true and consumes one email credit, including invalid syntax or an undeliverable address. Provider, configuration, or inconclusive lookup failures use status=false with error and reason_code; the reserved credit is refunded to its original pool row. If restoration fails, reason_code is credit_refund_pending. Responses use HTTP 200 for completed checks and application-level errors.

get/checkemail

Request

Base URL: https://proweblook.com/api/v1
URL: https://proweblook.com/api/v1/checkemail
Auth: API key in query parameter api_key

Query parameters

emailstring required

Example:user@example.com

Address to verify. Invalid syntax returns a completed invalid_format result and consumes one email credit.

Response

Completed verification or application-level error

balanceinteger

Current remaining email credits after the check or refund attempt. Omitted when API authentication fails.

statusboolean required

True for a completed check, including an invalid address; false for authentication, credit, or lookup failure.

emailstring

Checked address; present on completed checks.

emailformatboolean

Whether the address has valid syntax; present on completed checks.

emailexistboolean

True for deliverable or catch-all results; present on completed checks.

verdictstring

Completed check verdict: deliverable, undeliverable, unknown (catch-all), or invalid_format.

reason_codestring

Lookup reason on completed checks or lookup failures; credit_refund_pending means restoration could not complete. Omitted for authentication or insufficient-credit errors.

errorstring

Human-readable error when status is false.

Example response

{
  "balance": 99,
  "status": true,
  "email": "user@example.com",
  "emailformat": true,
  "emailexist": true,
  "verdict": "deliverable",
  "reason_code": "mailbox_accepted",
  "error": "Service temporarily unavailable, please try again."
}

Changes

No recorded changes to this operation across all 1 revision of this API.