Skip to content
Console(opens in a new tab)

RegisteredEntity

Businesses which have become legal entities by registering with a U.S. Secretary of State (SoS).

Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.

Businesses which have become legal entities by registering with a U.S. Secretary of State (SoS).

Each state’s SoS is the ultimate source of truth for these records.

A business may form in one state (“domestic registration”), and register with other states to conduct business there (“foreign registration”). We join these records together to represent the single entity they constitute.

Shortest path from a primary entity: Brand → legalEntities → LegalEntity → registeredEntities → RegisteredEntity.

Field Label Type Description
rank Rank Int Determines the display order of the attribute, with lower values shown first
name Name String This is the standardized name of the entity, derived from the name as listed on the entity’s registration.
id ID UUID! The unique identifier of this object.
firstObservedDate First Observed Date String The earliest date of a source record that supports this registered entity. The value is null when it is the same as lastObservedDate, because some sources supply only one snapshot of this data.
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.
registeredEntityType Registered Entity Type String The standardized legal form of the entity, e.g. “Corporation”, “LLC”, etc.
formationDate Formation Date Date The earliest non-null issue_date from the entity’s registrations, formatted YYYY-MM-DD.
formationYear Formation Year Int The year (YYYY) of the earliest non-null issue_date from the entity’s registrations.
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.
internalRegisteredEntityId String A numeric identifier that Enigma assigns to the registered entity when it builds its data. All RegisteredEntity objects for one registered entity share this value.
nameFullTextSearchVector String The search terms that Enigma makes from name for full-text search. Each term is a normalized word from the name, with its position in the name.

Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.

Field Leads to Description
registrations Registration Business registrations filed with a Secretary of State (or equivalent) in a U.S. state or territory. Default first: 100.
legalEntities LegalEntity Legal entities that this registered entity is an instance of. 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.

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
legalEntities(first: 1) {
edges { node {
registeredEntities(first: 1) {
edges { node {
id
rank
name
firstObservedDate
lastObservedDate
} }
}
} }
}
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"legalEntities": {
"edges": [
{
"node": {
"registeredEntities": {
"edges": [
{
"node": {
"id": "000000c4-0001-6f58-0000-0a8000000000",
"rank": 0,
"name": "SAFEWAY, INC.",
"firstObservedDate": "1993-01-02 00:00:00+00",
"lastObservedDate": "2026-09-14 01:38:10+00"
}
}
]
}
}
}
]
}
}
]
}
}