Data model

Learn about the required entity types and attributes that Reltio Identity Builder uses to perform matching and enrichment.

Attention: This feature is available to limited users through the Reltio Early Access (EA) program. Interested in finding out more about this feature or participating in our EA program? Get details in topic Early Access (EA) features.

The Reltio Identity Builder data model is derived from the Reltio B2C velocity pack. The model is based on the Individual and Location entity types.

Individual records store person-level identity attributes and related nested attributes. Location records store address details. Individual records are connected to Location records through the IndividualHasAddress relationship.

The Individual entity also contains nested attribute groups for OtherNames, Email, and Phone, which are used to represent aliases and contact points.

Entity types and relationships

The following elements make up the core Identity Builder data model.


Element	Type	Description
Individual	Entity type	Represents a single person. Stores name, birth, demographic, behavioral, and contact-related attributes used by Reltio Identity Builder.
Location	Entity type	Represents a physical address. Stores address lines, locality, postal codes, validation status, and related codes.
IndividualHasAddress	Relationship	Connects an Individual to a Location. Stores relationship-level attributes such as address type, the first time the address was seen for the individual, and the last time the address was validated.
OtherNames	Nested attribute on Individual	Represents other names used for the individual, including combined alias values and separate prefix, first, middle, last, suffix, and gender elements.
Email	Nested attribute on Individual	Represents email addresses used to contact the individual, including type, full email value, and related metadata such as domain and first or last seen dates.
Phone	Nested attribute on Individual	Represents phone numbers used to contact the individual, including number, type, line type, confidence score, and first or last seen dates.

Individual attribute groups

Reltio Identity Builder uses the following attribute groups on the Individual entity. Attribute names match the Identity Builder configuration.

Core Individual attributes

These attributes describe the individual and their activity history.

Name Prefix – name prefix, such as Mr. or Ms.
First Name – first name of the individual.
Middle Name – middle name of the individual.
Last Name – last name of the individual.
Name Suffix – suffix, such as Jr., Sr., I, II, or III.
Gender – gender of the individual.
Year of Birth – known year of birth.
Month of Birth – known month of birth.
Estimated Age – estimated age of the individual.
First Seen – first time activity for the individual was observed in the dataset.
Last Seen – most recent time activity for the individual was observed in the dataset.
IP Address – IP address or addresses associated with the individual.
Web Interests – URLs and classifications of websites the individual has interacted with.
Deceased Indicator – indicates whether the individual is deceased.
Household ID – household identifier assigned to the individual by Identity Builder.

Alias (OtherNames) attributes

These nested attribute group stores alternate names for the individual entity type.

Other Name – combined alternate name value, including all name elements.
Type – type of alternate name.
Other Name Prefix – prefix for the alternate name.
Other First Name – alternate first name, such as a nickname or abbreviation.
Other Middle Name – alternate middle name.
Other Last Name – alternate last name, such as a maiden or prior married name.
Other Name Suffix – suffix for the alternate name.
Other Name Gender – gender value associated with the alternate name.
Display Sequence – order in which the alternate name is intended to be displayed.

Address attributes

Address information is modeled as a reference from Individual to Location through the Address attribute and the IndividualHasAddress relationship.

The following attributes are used on the relationship and Location entity:

Address Type – type of address.
Address First Seen – first time the address was seen for the individual.
Address Last Validated – last time the individual was validated to reside at the address.
Address Line 1 – primary address line, such as house number and street.
Address Line 2 – secondary address line, such as unit or apartment.
City – city name.
State – state abbreviation.
Country – country name.
Zip 5 – five-digit ZIP code.
Zip 4 – four-digit ZIP+4 suffix.
Vacancy Indicator – indicates whether USPS lists the address as vacant.
Delivery Point Code – delivery point code with check digit.
DPV – Delivery Point Validation result for the address.
Zip 4 Type – ZIP+4 type, such as firm, general delivery, high-rise, PO Box, rural route, or street.
Carrier Route Code – carrier route code for the address.
FIPS County Code – FIPS county code for the address.

Email attributes

The Email nested attribute group stores email addresses and related metadata.

Email – full email address, including local part and domain.
Email Type – type of email address, such as business or personal.
Domain – domain portion of the email address.
Domain Type – type of email domain.
Username – username portion of the email address.
Rank – ordinal rank of the email address for contacting the individual.
Validation Status – validation status of the email address.
Active – indicates whether the email address is active.
Email First Seen – first time the email address for the individual was seen.
Email Last Seen – last time the email address for the individual was seen.
Email Received Date – date when the email record was received in the dataset.

Phone attributes

The Phone nested attribute group stores phone numbers and related metadata.

Type – type of phone number used by the individual.
Number – phone number.
Country Code – country code for the phone number.
Formatted Number – formatted version of the phone number.
Extension – extension number for reaching the individual.
Rank – ordinal ranking of the phone number for contacting the individual.
Area Code – area code for the phone number.
Local Number – phone number in local service format.
Validation Status – validation status of the phone number.
Line Type – probable line type, such as landline, VOIP, wireless, other, or fax.
Format Mask – format mask applied to the phone number.
Digit Count – number of digits in the phone number.
Geo Area – geographic area associated with the phone number.
Geo Country – country associated with the phone number.
Primary Phone Flag – indicates whether the number is the primary phone for the individual.
Active – indicates whether the number is active.
Unreachable – indicates whether the individual has been unreachable at this number.
Confidence Score – indicates whether the phone number or provider was validated, verified, or disconnected or delisted.
Direct In-Dial – indicates whether the number is a direct in-dial number.
Directory Assistance Code – indicates whether the number is listed in directory assistance or delisted or disconnected.
Original Provider – name of the original telecommunications provider associated with the phone number.
Phone First Seen – first time the phone number for the individual was seen.
Phone Last Seen – last time the phone number for the individual was seen.

Unify and manage your data