API Reference

The OpenGuardian API provides a single POST /v1/verify endpoint that accepts an email address and returns a verification verdict. Responses typically arrive in under 300ms.

All requests must include your API key in the Authorization header: Bearer <your-api-key>. The request body is a JSON object with a single email field.

The response includes: verdict (VALID, DISPOSABLE, RISKY, or UNDELIVERABLE), score (0–100), checks (object with per-check results), and request_id for debugging.

Rate limits are applied per API key. The free tier allows 1,000 requests per month. Paid plans have higher limits — see the pricing page for details.