API reference

Single verification

Real-time verification for one address at a time. Returns a status plus a confidence score, recommended action and reason codes.

Endpoint

POST/api/verify

Request body

Parameter	Type	Description
email*	string	The email address to verify.

Try it

Try it · sandboxSimulated, no key needed

Examples

POST /api/verify

curl https://api.purelist.io/api/verify \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"email":"alex@example.com"}'

Response fields

Parameter	Type	Description
id	string	Stable verification ID.
status	enum	VALID · INVALID · RISKY · ROLE
score	integer	Deliverability score from 0 to 100.
confidence	float	Confidence the address is deliverable (0–1).
bounce_probability	float	Estimated bounce risk (0–1).
action	enum	send · send_low_priority · risky · skip
risk	enum	low · medium · high
reasons	array	Machine-readable reason codes, e.g. catch_all_detected.
mailbox_confirmed	boolean	True only if the specific mailbox was confirmed via SMTP.
verification_method	string	smtp_mailbox · domain_only · catch_all · history · …
checks	array	Per-stage results: syntax, MX, SMTP, mailbox, disposable, role, catch-all.