Email Lookup Tutorial
Overview
Email Lookup is a real-time solution for retrieving information about the owner of a given email address.
Email Append URI
The Email Lookup URI accepts an email address and returns the owner’s name and address.
Required Information
The Email Lookup URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.
The Email Lookup URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key The Email Lookup URI must be used with a POST request, where the request payload contains the email address to look up.
Example
Request URL
The URL for the Email Lookup URI is: https://api.thedatagroup.com/{version}/sync/lookup/email, where {version} is the API Version you wish to use.
Request Headers
| Header Attribute | Header Value |
|---|---|
| x-api-key | {your api key} |
| AuthorizationToken | {your authorization token} |
| Content-Type | application/json |
Request Payload
The request payload for the Email Lookup URI must contain the email attribute.
{ "email": "richard.young@fakeemail.com" }cURL Example
To query the Email Lookup URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.
curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{ "email": "richard.young@fakeemail.com" }' "https://api.thedatagroup.com/v3/sync/lookup/email"Response Payload
The response payload for the Email Lookup URI will contain the name and address information of the person associated with the request email address.
{ "first_name": "Richard", "last_name": "Young", "address": { "street_number": "4689", "street_name": "Lakewood", "street_type": "DR 