#for-agents
For Agents
TinyValidator is easiest to use as a server-side email verification tool. Start with the OpenAPI contract for machine-readable usage.
##Best fit
-Server-side signup checks before a user record is created
-Lead capture forms that need typo suggestions and disposable-email blocking
-CRM or ESP list cleaning with CSV upload and background processing
-Agent workflows that need a fast answer for whether an email looks safe to use
##Core actions
Verify a single email
Use the synchronous verification endpoints when an agent needs an immediate decision for one address.
GET /api/v1/[email protected]Run bulk validation
Create a job, upload a CSV to the presigned URL, then track status or wait for a webhook.
POST /api/v1/bulk-validationsConfigure webhooks
Use webhook settings to receive completion events instead of polling long-running jobs.
POST /api/v1/webhooks##Agent notes
-Use Authorization headers with a server-side API key whenever possible.
-Prefer the query-parameter verify endpoint for straightforward tool calling.
-Use bulk validation for lists instead of looping one-by-one through the verify endpoint.
-Treat suggestion, deliverability, disposable, catch_all, and role_account as distinct decision signals.
-Keep humans in the loop for irreversible actions or risky/catch-all addresses.