Reverse Email Append API Documentation

Introduction The TDG Email Append API enables enterprises to enrich fragmented customer records with verified email addresses in real-time. By matching physical markers against our identity graph, this email appending service provides a high-fidelity bridge for omnichannel marketing. Organizations can scale their outreach and optimize their email append cost by accessing direct-source data.

Authentication To access data, 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 technical support team to receive your unique x-api-key. [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.

Managing Your API Key Proper management of your API Key is crucial. Ensure it is kept confidential and not shared publicly or hard-coded in client-side applications. Rotate your keys periodically and revoke them immediately if compromised.

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 Protocols HTTPS encryption is mandatory for all requests. Request and response bodies are encoded as JSON format.

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 LOOKUP)

Email Lookup Perform identity resolution on a specific email address. This reverse email append service returns verified consumer names and physical location data for database optimization.

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://testapi.tdg1.io/v3/lookup/email

				
					Sample Request

curl --location 'https://testapi.tdg1.io/v3/lookup/email' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api_key>' \
--data '{
    "Email": "<Tom.Smith@Sample.com>"
}'

				
					Sample Response

{
  "Name": {
    "LName": "TOM",
    "FName": "SMITH",
    "MName": ""
  },
  "Address": {
    "House": "1021",
    "PreDir": "",
    "Street": "Street",
    "StrType": "",
    "PostDir": "",
    "AptType": "",
    "AptNbr": "",
    "City": "LAKES",
    "State": "FL",
    "Zip": "91546",
    "CNTY": "053",
    "Deliverable": "Y",
    "ValDate": "20190601"
  },
  "trace": "924c3bde-c3c4-4a27-8253-e3b0109ae67b2"
}

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

Compliance Notice: The Data Group is not a Consumer Reporting Agency (CRA). Our reverse email append service and identity resolution tools are for marketing and lead validation purposes only. Data may not be used for FCRA-regulated purposes, such as determining eligibility for credit, insurance, or employment.

Need Technical Assistance?

Our engineering team is available for custom integration support and technical consultations.