APIDocs

v122 endpoints

API Reference

Verify single emails, run bulk jobs, find professional emails by name, embed the FoxGuard widget on any form, and manage your API keys and credits.

Authentication

All REST endpoints require an API key via the X-API-Key header. Create keys in your dashboard.

Key Scopes

fullAll endpointsverifyEmail verification onlyread-onlyGET requests only

FoxGuard WidgetNo Auth

Protect any email input with one script tag. No API key required for the free public tier — 4 verifications per day per device.

Widget docs Try it live →

Quickstart

Verify your first email in seconds.

Request

curl -X GET "https://api.verifox.ai/v1/email-validation/john@example.com" \
  -H "X-API-Key: vfx_your_api_key"

200 OK

{
  "email": "john@example.com",
  "domain": "example.com",
  "isValid": true,
  "reachable": "safe",
  "syntax": true,
  "smtp": {
    "deliverable": true,
    "catchAll": false,
    "hostExists": true
  },
  "isFree": false,
  "isRole": false,
  "isDisposable": false,
  "hasGravatar": true,
  "suggestion": null,
  "verifiedAt": "2026-03-31T10:30:00Z"
}

Endpoints

5 modules · 22 endpoints

Email Validation

Verify individual emails or run bulk jobs. Checks syntax, SMTP deliverability, disposable providers, role accounts, and more.

GET/:emailPOST/POST/bulk+2 more

Email Finder

Find anyone's professional email address using their name and company domain. Uses smart permutation and SMTP verification.

POST/GET/:jobIdGET/history+2 more

Drop-in real-time email validation for any HTML form. Add two script tags before </head> — FoxGuard auto-discovers every [type="email"] input and validates as the user types. No backend changes. Supports a free public tier (4 req/day) and unlimited with an API key.

GET/validatePOST/public-verify

API Keys

Create and manage API keys for authenticating requests. Each key has a scope, optional IP restrictions, and an expiry. The full key is shown only once on creation — store it securely.

POST/GET/GET/analytics+1 more

Credits & Balance

Check your Fox Credits balance, view the transaction history for every deduction and top-up, and pull usage statistics for dashboard charts.

GET/balanceGET/transactionsGET/stats

Error Codes

All errors return { error: string }

Code	Status	Action
`200`	OK	Request completed
`201`	Created	Resource created
`202`	Accepted	Job started — poll for results
`400`	Bad Request	Check your request parameters
`401`	Unauthorized	Invalid or missing API key
`402`	Payment Required	Insufficient Fox Credits
`404`	Not Found	Resource doesn't exist
`429`	Rate Limited	Slow down — wait before retrying
`500`	Server Error	Retry after a short delay
`503`	Unavailable	Database unavailable — retry

200

Request completed

201

Created

Resource created

202

Accepted

Job started — poll for results

400

Bad Request

Check your request parameters

401

Unauthorized

Invalid or missing API key

402

Payment Required

Insufficient Fox Credits

404

Not Found

Resource doesn't exist

429

Rate Limited

Slow down — wait before retrying

500

Server Error

Retry after a short delay

503

Unavailable

Database unavailable — retry