Skip to content
Console(opens in a new tab)

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.

Shortest path from a primary entity: Brand → roles → Role.

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.

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.

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.

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"
}
}
]
}
}
]
}
}