Get started

    API Endpoint

         "<datazapp api endpoint URL>"

Upload lists of Email addresses to append associated postal and phone data. Or keep your email addresses secure by uploading hashed SHA256 or MD5 Email strings. Datazapp takes hashed Email records and recovers their associated Email addresses along with basic information: Name, Address, City, State, Zip & Phone number.

To use this API, you need an API key. Please contact us at [email protected] to get your API key.

Reverse Email Append API Request

Query Parameters

Request                    
{
    "ApiKey": "",
    "AppendModule": "EncryptedEmailAppendAPI",
    "AppendType": 5,
    "Isb2bOnly": 1,
    "Data": [
        {
            "Email": "xxxxxxxxxxx.xx"
        }
    ]
}

Parameter	Required	Description	Type
APIKey	required	Issued by sales support or Datazapp Admin	String
AppendModule	required	Value should be EncryptedEmailAppendAPI	String
AppendType	Required	1 – SHA Input, 2 – MD5 Input, 5 – Email Input	Integer
IsPhoneOnly	Optional	True-Only matching records with Cell / Phone, False – All Records	String
Email	required	Email(s) to verify	String
Isb2bOnly	Required	For retrieving business-only records.(1-True and 0-false)	Integer

Response

Query Parameters

                    

Response

{
    "header": {
        "Status": 0,
        "Message": null
    },
    "ResponseDetail": {
        "App": 0,
        "Token": "QxxxxB",
        "Data": [
            {
                "Company": "W***********IES",
                "JobTitle": "MAR*************ATIVE",
                "Industry": "",
                "LinkedInURL": "linkedin.com/in/l*****17****1b",
                "CompanyWebsite": "",
                "CompanyCountry": "united states",
                "Matched": true,
                "FirstName": "L***A",
                "LastName": "S***P",
                "Address": "",
                "City": "P****X",
                "State": "AZ",
                "ZIP": "",
                "Country": "united states",
                "Email": "1*******om",
                "emailHash": null,
                "Cell": "",
                "CellDNC": "",
                "Phone": "",
                "PhoneDNC": ""
            }
        ],
        "OrderAmount": "$x.xx",
        "Count": 1,
        "Message": null,
        "ProcessedTime": "xxx milliseconds"
    },
    "Status": true,
    "Message": null
}

Field	Type	Description
Following Parameters Should be Sent in Header:
Status	Integer	Indicates header status
Message	String	Indicates type of error
Following Parameters Should be Sent in ResponseDetail:
App
Token	String	System-generated reference.
Following Parameters Should be Sent in Data Object in Array Format:
Company	String	Name of the company the person is working for.
JobTitle	String	A person’s designation in the company.
Industry	String	The industry to which the company belongs.
LinkedInURL	String	LinkedIn profile URL of the person.
CompanyWebsite	String	Website of the company.
CompanyCountry	String	The country where the company is located.
Matched	String	True if matched, False if not matched.
FirstName	String	First name of the person in the household.
LastName	String	Last name of the person in the household.
Address	String	Address of the individual from the United States.
City	String	City of the individual from the United States.
State	String	State of the individual from the United States.
ZIP	String	Zip code associated. Zip or Zip+4 is accepted.
Country	String	United States
Email	String	Email of the person.
EmailHash	String	Hashed email of the person.
Cell	String	Cell phone number of the person in the household.
CellDNC	String	Yes, No
Phone	String	Landline phone number of the person in the household.
PhoneDNC	String	Yes, No
OrderAmount	String	Amount of the order.
Count	String	Number of counts.
Message	String	Null
ProcessedTime	String	Processing time.
Status	String	True, False
Message	String	Null

Errors

The API uses the following error codes:

Error Code	Meaning
Module does not exist.	The specified module does not exist or Invalid AppendModule Name.
User not found.	Invalid API Key or The user associated with the API key was not found
Append Request not found	Invalid Token: The specified append request could not be found
Improper JSON Data. Please check.	The JSON data in the request does not match the expected format.
It seems like API has an issue. Please contact Support.	There is an issue with the API. Contact the [email protected]