API Documentation
Welcome to the verifi.email API documentation. Our REST API allows you to easily validate email addresses with high accuracy and performance.
Authentication
To use the verifi.email API, you need an API key. You can obtain a key by signing up for an account. Include your API key in all requests by appending the token=<your-api-key> query param.
Validate a single email
Validate a single email address to determine its deliverability and validity.
Request
GET /v1/validateQuery Parameters
| Parameter | Description |
|---|---|
token | Your API token |
email | The email address to validate |
Response
Returns a JSON object with validation results.
Bulk Validation
Validate multiple email addresses in a single request.
Request
POST /v1/validate/bulkQuery Parameters
| Parameter | Description |
|---|---|
token | Your API token |
Request body
| Parameter | Description |
|---|---|
emails | Array of email addresses to validate |
Response
Returns a JSON array of validation results for each email.
Response Codes
Our API uses conventional HTTP response codes to indicate the success or failure of an API request.
| Code | Description |
|---|---|
200 | OK - Everything worked as expected |
400 | Bad Request - Invalid parameters or request format |
401 | Unauthorized - Invalid API key |
402 | Payment Required - Account has exceeded quota or is past due |
429 | Too Many Requests - Rate limit exceeded |
500 | Server Error - Something went wrong on our end |
Rate Limits
Rate limits vary by plan. The current rate limit is returned in the response headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Number of requests allowed in the time window |
X-RateLimit-Remaining | Number of requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the rate limit resets |
Code Examples
JavaScript
Python
Need Help?
If you have any questions or need assistance with our API, please contact our support team at contact@verifi.email.