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.