# TinyValidator

> TinyValidator is an email verification API for blocking disposable accounts, catching typos, and scoring deliverability risk. It is best used from server-side agents, backend jobs, signup flows, CRM imports, and list-cleaning workflows.

## Start Here

- [For Agents](https://tinyvalidator.com/for-agents): Recommended entry point for agent operators and tool builders.
- [OpenAPI](https://tinyvalidator.com/openapi.json): Machine-readable contract for the main API flows.
- [Skill](https://tinyvalidator.com/skills/tinyvalidator-email-verification/SKILL.md): Public TinyValidator skill for agent workflow guidance.
- [Documentation](https://tinyvalidator.com/docs): Human-readable guides and examples.
- [Authentication](https://tinyvalidator.com/docs/getting-started/authentication): API key usage and security rules.
- [Quickstart](https://tinyvalidator.com/docs/getting-started/quickstart): First request in under five minutes.

## Best Fit

- Verify a single email before signup, checkout, or lead capture.
- Clean an existing list with bulk validation and download a result CSV.
- Trigger downstream workflows from webhook events instead of polling.
- Flag risky, disposable, typo, role-account, and catch-all addresses before sending email.

## Core API Actions

- GET /api/v1/verify?email=user@example.com: Verify a single email with query parameter input.
- GET /api/v1/verify/{email}: Verify a single email with path parameter input.
- POST /api/v1/bulk-validations: Create a bulk validation job and receive a presigned upload URL.
- GET /api/v1/bulk-validations: List bulk validation jobs for the authenticated organization.
- GET /api/v1/bulk-validations/{id}: Fetch job status, progress, and downloadable file references.
- GET /api/v1/files/{id}: Fetch file metadata and download links for input/result files.
- GET /api/v1/webhooks: Read current webhook settings.
- POST /api/v1/webhooks: Configure or disable webhook delivery settings.

## Authentication

- Preferred: Authorization: Bearer YOUR_API_KEY
- Supported: api_key query parameter
- API keys are server-side credentials. Do not expose them in client-side JavaScript, public repos, or browser network requests.

## Agent Notes

- Prefer the synchronous verification endpoints for one-off decisions.
- Prefer bulk validation for lists or background jobs.
- Prefer webhooks for completion events instead of polling.
- Treat suggestion, deliverability, disposable, catch_all, and role_account as decision inputs rather than raw pass/fail clones.
- Review risky or ambiguous results before taking irreversible actions.
- Documentation pages support markdown responses when requested with Accept: text/markdown or ?format=md.

## Useful Docs

- [Verify Emails](https://tinyvalidator.com/docs/guides/verifying-emails)
- [Bulk Email Validation](https://tinyvalidator.com/docs/guides/bulk-validation)
- [Webhooks](https://tinyvalidator.com/docs/guides/webhooks)
- [Understanding Scores](https://tinyvalidator.com/docs/guides/understanding-scores)
- [Free Email Verifier](https://tinyvalidator.com/docs/guides/free-email-verifier)

## Pricing

- Free: 1,000 validations per month
- Growth: 5,000 validations for $30
- Scale: 50,000 validations for $200
- Enterprise: 500,000 validations for $1,000

## Policies

- [Terms of Service](https://tinyvalidator.com/legal/terms)
- [Privacy Policy](https://tinyvalidator.com/legal/privacy)
- [Contact](https://tinyvalidator.com/contact)

## Discovery

- [Sitemap](https://tinyvalidator.com/sitemap.xml)
- [LLMs](https://tinyvalidator.com/llms.txt)