Get started

    API Endpoint

         "<datazapp api endpoint URL>"

DataZapp’s Reverse Phone Append api add Names, Addresses, and Email addresses to your phone records. First Names, Last Names, Mailing Address, City, State, & Zip code are included with each successful match. Email addresses are included where available.

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

Reverse Phone Append API Request

Query Parameters

Request                    
{
    "ApiKey": "Put your api key here",
    "AppendModule": " ReversePhoneAppendAPI ",
    "Data": [
        {
            "Phone": " (2xx) 2xx-xxx1"
        }
    ]
}

Parameter	Required	Description	Type
APIKey	required	Issued by sales support or Datazapp Admin	String
AppendModule	required	ReversePhoneAppendAPI	String
Phone	required	Phone number	String

Response

Query Parameters

                    

Response

{
    "header": {
        "Status": 0,
        "Message": null
    },
    "ResponseDetail": {
        "App": 0,
        "Token": "xxxxx",
        "Data": [
            {
                "Matched": true,
                "State": "AL",
                "ZIP": "xxxxx",
                "ZIP4": "xxxx",
                "Address2": "",
                "FirstName2": "CHxxxxxR",
                "LastName2": "COxxxx",
                "CompanyName": "CxxxxxxxxxS",
                "Email": "[email protected]",
                "FirstName": "PxxxNE",
                "LastName": "CxxxxN",
                "Address": "3xxxxxxxxxx",
                "City": "CxxxxxxxN",
                "Zip": null,
                "Phone": "2xxxxxxxx1",
                "PhoneType": "W",
                "DoNotCall": null
            }
        ],
        "OrderAmount": "$0.03",
        "Count": 1,
        "Message": null,
        "ProcessedTime": "xxx milliseconds"
    },
    "Status": true,
    "Message": null
}

Field	Type	Description
Following Parameters Should be send in Header:
Status	Integer	Indicate header status
Message	String	Indicate type of error
Following Parameters Should be send in ResponseDetails:
App
Token	String	System generated reference.
Following parameters should be sent in Data Object in Array format:
Matched	String	TRUE OR FALSE
FirstName	String	First name (name of person in household)
LastName	String	Last name (name of person in household)
FirstName2	String	First name2 (name2 of person in household)
LastName2	String	Last name2 (name2 of person in household)
Address	String	Valid United states postal address.
Address2	String	Valid United states postal Secondary address.
City	String	Valid City of United states.
State	String	Valid State of United states.
ZipCode	String	ZipCode of the postal address
Zip4	String	Zip4 of the postal address
CompanyName	String	Business Company name
Email	String	Email of person.
Phone	String	Phone(landline) number of person in household
PhoneType	String	Wireless, Landline.
DoNotCall	String	Yes ,No
OrderAmount	String	Amount of count
Count	String	Number of count
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
Getting 401 Error.	The user does not have access to this API
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]