Email Validation API Documentation
Introduction The TDG Email Validation API is a technical infrastructure designed for real-time hygiene and sender reputation protection. This email checker api performs mailbox-level verification to ensure deliverability without sending actual emails. By integrating our email validation software, enterprises can execute bulk email verification and automate email list cleaning workflows to remove toxic domains and identify spam traps.
Authentication To access the validation engine, you must authenticate your requests using an API Key. By authenticating your requests with an API Key, you ensure secure and authorized access to our data services, allowing you to integrate our comprehensive and reliable data seamlessly into your applications and workflows.
Obtaining an API Key To obtain an API key, please contact our support team to receive your unique x-api-key within 24 hours. [Contact Us]
Including the API Key in Requests When interacting with our data services through APIs, SDKs, or command-line interfaces (CLI), it’s essential to include your API Key in the request. This API Key acts as a unique identifier that authenticates and authorizes your request to access our data.
Best Practices Use HTTPS to encrypt API Key transmissions over the network, preventing interception by unauthorized parties. Implement rate limiting and access controls based on API Key usage to manage and monitor access effectively.
Security Use HTTPS for all transmissions. Request and response bodies are encoded as JSON.
CONVENTIONS
The base URL to send API requests is segregated into 3 categories.
- Lookup: https://api.tdg1.io/v2/lookup
- Append: https://api.tdg1.io/v2/append
- Verify: https://api.tdg1.io/v2/verify
HTTPS is required for all API requests. The TDG API follows RESTful conventions when possible, with most operations performed via POST requests on database resources. Request and response bodies are encoded as JSON.
ENDPOINT SPECIFICATIONS (EMAIL VERIFY)
Email Verify Validate the accuracy and status of consumer email addresses. This email verification service is built for high-scale processing and low-latency integration into lead forms and CRM systems.
HEADERS
- x-api-key (string) | required: Unique key obtained after contacting us.
BODY PARAMS
- Email (string) | required: Individual email address. 100 Characters maximum.
POST: https://api.tdg1.io/v2/verify/email
Sample Request
curl --location 'https://api.tdg1.io/v2/verify/email' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api_key>' \
--data '{
"Email":"<Tom.Smith@Sample.com>"
}
Sample Response
{
"Email": "Tom.Smith@Sample.com",
"Result": "Complainer"
}
DEVELOPER TOOLS (SDK & POSTMAN)
TDG SDK The TDG SDK is an open-source project designed to simplify the process of integrating our data services into your applications. By using the SDK, developers can easily access and utilize our API functionalities, ensuring a smooth and efficient development experience.
- Access: Read Documentation on PyPI
Postman Collection Postman is a powerful tool that simplifies API development and testing. It allows you to easily create, test, and manage your API requests without writing any code. Using Postman with the TDG API provides a user-friendly way to explore and integrate our data services.
- Run in Postman: [Import TDG Collection]
- Technical Docs: View Documentation
API RESPONSE CODES
HTTPS STATUS CODE | Description |
200 | Successful |
204 | No Records found |
400 | Missing required parameter(s) |
401 | The user is invalid (verify your credentials) |
429 | You have reached the maximum number of transactions allowed |
440 | Too many results. Please refine your search criteria |
500 | System error. Retry search, if failure continues, contact support |
Need Technical Assistance?
