Getting Started
Zeruh is a powerful email verification service that helps you verify email addresses in real-time. Our platform is designed to be simple and easy to use, allowing you to integrate email verification into your applications with minimal effort. This platform is an extension of Maileroo and has been built on its own isolated platform, but can be accessed via single-sign-on from your Maileroo dashboard.
What is Zeruh?
Zeruh is an email verification API that validates email addresses to determine if they are valid and deliverable. Our service performs comprehensive checks including:
- Format Validation - Ensures the email follows proper syntax
- Domain Verification - Checks if the domain exists and has valid MX records
- SMTP Verification - Tests if the mailbox actually exists
- Quality Assessment - Identifies disposable emails, catch-all domains, and role-based addresses
- IP Intelligence - Provides location and proxy/VPN detection when IP addresses are provided
Base URL
The base URL for the Zeruh API is provided below. All endpoints are relative to this base URL and should be accessed using HTTPS.
https://api.zeruh.com/v1
Authentication
Once you have your API key, you can use it in your requests. Here are the three supported authentication methods:
1. X-Api-Key Header (Recommended)
curl -X GET "https://api.zeruh.com/v1/account" \
-H "X-Api-Key: YOUR_API_KEY"
2. Query Parameter
curl -X GET "https://api.zeruh.com/v1/account?api_key=YOUR_API_KEY"
3. Form Parameter
curl -X POST "https://api.zeruh.com/v1/account" \
-d "api_key=YOUR_API_KEY"
HTTP Response Codes
The Zeruh API uses standard HTTP status codes to indicate the success or failure of a request. The following table lists the possible HTTP status codes and their meanings.
HTTP Code | Reason |
---|---|
200 OK | The request was successful. Verification may not necessarily be successful. |
403 Forbidden | Invalid API key or IP address is not in the allowed list. |
429 Too Many Requests | Rate limit exceeded. Please try again later. |
500 Internal Server Error | An unexpected error occurred. Please try again later. |
Rate Limiting
By default, the Zeruh API has a rate limit of 30 requests per second. This limit can be increased upon request.