- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
Role
These are roles which people (and other legal entities) hold at U.S. businesses.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
These are roles which people (and other legal entities) hold at U.S. businesses.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → roles → Role.
LegalEntity.rolesBrand.rolesOperatingLocation.rolesRegistration.rolesPhoneNumber.rolesRecord.rolesEmailAddress.roles
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
externalId |
External ID | JSON |
The ID of the person in this role in the third-party contact data that supplied the role, as an object with the source name and the ID value. Roles from other sources have no value. |
externalUrl |
External URL | String |
|
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
jobTitle |
Job Title | String |
The standardized job title observed in our datasets. |
jobFunction |
Job Function | String |
The standardized job description for this role. |
managementLevel |
Management Level | String |
The standardized management level for this role. |
startDate |
Start Date | Date |
The date the person started this role. |
startDatePrecision |
Start Date Precision | String |
Whether start_date is precise to the day, month, or year. |
endDate |
End Date | Date |
The date the person ended this role. |
endDatePrecision |
End Date Precision | String |
Whether end_date is precise to the day, month, or year. |
internalId |
String |
A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number. |
|
internalRoleId |
String |
A numeric identifier that Enigma assigns to the role when it builds its data. All Role objects for one role share this value. |
Connections
Section titled “Connections”Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.
| Field | Leads to | Description |
|---|---|---|
operatingLocations |
OperatingLocation |
Operating locations where this role is performed. Default first: 100. |
phoneNumbers |
PhoneNumber |
The phone number for a particular business entity. Default first: 100. |
emailAddresses |
EmailAddress |
An email address for the business or a person associated with the business. Default first: 100. |
legalEntities |
LegalEntity |
Legal entities, such as persons, that perform this role. Default first: 100. |
registrations |
Registration |
Business registrations filed with a Secretary of State (or equivalent) in a U.S. state or territory. Default first: 100. |
records |
Record |
A structured entry from an upstream data source, such as a government filing or business registration, from which Enigma derives and links business entities. Default first: 10. |
brands |
Brand |
Brands where this role is performed. Default first: 100. |
Math fields
Section titled “Math fields”Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id roles(first: 1) { edges { node { id externalId externalUrl firstObservedDate lastObservedDate } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "roles": { "edges": [ { "node": { "id": "000008c2-0003-0dfc-0000-0b8000000000", "externalId": null, "externalUrl": null, "firstObservedDate": "2026-06-02 03:09:16+00", "lastObservedDate": "2026-06-02 03:09:16+00" } } ] } } ] }}