post https://us.identity.api.liveramp.com/v1/entities/
Make single transaction calls to the Lookup endpoint to match an individual record.
Lookup Type Parameter and Lookup Value
The lookup_type
parameter is used to specify the type of input data included in the API call.
The key
parameter specifies the hashed input data lookup value for the call depending on the lookup_type
parameter. The key
parameter is required for all Lookup endpoint requests.
"lookup_type" Parameter | Required Lookup Value for "key" Parameter | Supported Input Data Values | Lookup Value Examples |
---|---|---|---|
md5 | MD5 hashed email addresses | 9b7ee2211f2658e9889960d8557086eb | |
sha256 | SHA-256 hashed email addresses | ee3d7fe2d416373c74a38f44d0404635dcc273d41a9b1391a991f | |
sha1 | SHA-1 hashed PII strings (including SHA1 hashed email addresses) | Email Phone Name + Email Name + Phone Name + ZipCode | ac04b6f3667ddb3d165abcb6962ef135dbb982fc |
Constructing Names
See the table below for information on the elements that can be included when constructing names.
Name Element | Description | Example | Required? |
---|---|---|---|
First Name | The person's first name. | Eduardo Felicia | Yes |
Middle Name | The person's middle name or middle initial. | Kyu k john j | No |
Last Name | The person's last name. | Lopez Nguyen | Yes |
Generational Suffix | The person's generational name suffix. | Jr Sr II | No |
General Construction Rules
The rules listed below apply to all PII string types:
- Strings must be UTF-8 encoded.
- If a field is empty, it should be excluded from the string.
- Separate fields with single spaces. Don't add additional spaces if you leave out a particular field.
- Convert all fields to lowercase before hashing.
- Phone number should be digits only with no special characters.
- Hyphens are allowed except in phone numbers.
- Remove all periods (.) from name and phone fields. Do not remove periods from email addresses.