- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
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).
Data sources
Section titled “Data sources”Each state’s SoS is the ultimate source of truth for these records.
Methodology
Section titled “Methodology”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.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → legalEntities → LegalEntity → registeredEntities → RegisteredEntity.
LegalEntity.registeredEntitiesRegistration.registeredEntitiesRecord.registeredEntities
Fields
Section titled “Fields”| 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. |
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 |
|---|---|---|
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. |
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 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" } } ] } } } ] } } ] }}