Demographics Append
GET/v5/td
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.
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 |
|---|---|---|
| demo@atdata.com | Tower Data | 33 Irving Pl Ste 4048, New York, NY 10003 |
| sample@atdata.com | Caitlin Plackard | 789 Chestnut St., San Francisco, CA 94123 |
All request parameters are required to be URL encoded.
Request
Responses
- 200
- 400
Success. Find detailed information about the Demographics Response Object here.
Bad Request