Demographics Append

get

https://api.atdata.com/v5/td

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This endpoint retrieves data on a single person using email and/or postal address.

Postal parameters are used to query by United States postal address, and when used, name parameters must be included. All postal parameters need to be URL encoded. Street, city, state, and zip must be provided together or street, city, and state, or street and zip. Using the standardized format for postal addresses is recommended.

📘
Tip
Querying by email, name, and postal together will give you the highest match rate. Querying by email and name will give you a better match rate than by email alone, and regular text emails will match better than MD5 or SHA1 versions.

The table below presents email and postal addresses you can use to test the responses of the Demographics API:

Email Address	Name	Address
[email protected]	Tower Data	33 Irving Pl Ste 4048, New York, NY 10003
[email protected]	Caitlin Plackard	789 Chestnut St., San Francisco, CA 94123

🚧
URL Encoding
All request parameters are required to be URL encoded.

Query Params

string

The raw email address. It must be URL encoded.
Example: [email protected] encoded outputs to: demo%2Bemail%40atdata.com

sha1_email

string

SHA-1 hashed email. The email must be lower case and stripped of white spaces before being hashed.
Example: [email protected] hashed outputs to: 1d604932232d089ab1a1cad148f20d942db666a7

md5_email

string

MD5 hashed email. The email must be lower case and stripped of white spaces before being hashed.
Example: [email protected] hashed outputs to: 3cf1e81405a4bdf4f7e3a2453cd441c3

first

string

First name of the person.

middle

string

Middle name of the person (optional).

last

string

Last name of the person.

street

string

Street number & name.

city

string

Name of the city.

state

string

Two-letter state abbreviation.

zip

string

Five-digit zip code, optionally followed by a four-digit extension separated by a dash.

format

string

You can change the output format to print responses as HTML within a browser. Example: format=html.

fields

string

A comma-separated list of the data fields you want returned. By default, all available fields are returned.

api_key

string

required

Your AtData API key.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Tip

URL Encoding

200Success. Find detailed information about the Demographics Response Object here.

400Bad Request