llms.txt Content
# VeriMails API
Base URL: https://verimails.com
## Human Docs
- https://verimails.com/docs
- https://verimails.com/docs/quickstart
- https://verimails.com/docs/authentication
- https://verimails.com/docs/single-verification
- https://verimails.com/docs/bulk-verification
- https://verimails.com/docs/email-finder
- https://verimails.com/docs/result-codes
- https://verimails.com/docs/rate-limits
- https://verimails.com/docs/errors
- https://verimails.com/docs/agent-resources
## Agent-Readable Docs
- https://verimails.com/docs/index.md
- https://verimails.com/docs/agent-resources.md
- https://verimails.com/docs/quickstart.md
- https://verimails.com/docs/authentication.md
- https://verimails.com/docs/single-verification.md
- https://verimails.com/docs/bulk-verification.md
- https://verimails.com/docs/email-finder.md
- https://verimails.com/docs/result-codes.md
- https://verimails.com/docs/rate-limits.md
- https://verimails.com/docs/errors.md
- https://verimails.com/docs/api.md
- https://verimails.com/docs/examples.md
- https://verimails.com/llms-full.txt
- https://verimails.com/openapi.json
- https://verimails.com/openapi.yaml
## Authentication
API requests use a Bearer token:
```http
Authorization: Bearer YOUR_API_KEY
```
## Credits
- Email verification: 1 credit verifies 1 submitted email address.
- Bulk verification: 1 credit is reserved for each submitted address when a job is created.
- Email Finder: 20 credits are charged only when a verified email is found.
- New accounts receive 100 signup credits. Prepaid credits never expire.
## Core Endpoints
- `POST /api/verify/single` - verify one address.
- `POST /api/verify/batch` - verify up to 500 addresses in one request.
- `POST /api/bulk` - upload a CSV and create an asynchronous bulk job.
- `GET /api/bulk/{job_id}` - check bulk job status.
- `GET /api/bulk/{job_id}/download` - download all bulk results as CSV.
- `GET /api/bulk/{job_id}/download/safe` - download safe-to-send rows.
- `GET /api/bulk/{job_id}/down
OpenAPI Spec (preview)
{
"openapi": "3.0.3",
"info": {
"title": "VeriMails API",
"version": "1.0.0",
"summary": "Email verification, bulk list verification, and an Email Finder.",
"description": "VeriMails verifies email addresses with syntax validation, MX record lookup, DNS checks, and a live SMTP handshake where the receiving server allows it. It detects catch-all domains, disposable addresses, and role-based addresses, and returns an overall deliverability result.\n\nThe API also includes async