- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
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.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
A structured entry from an upstream data source, such as a government filing, business registration, or third-party database record. Enigma links resolved business entities back to the records from which they were derived, enabling traceability to the underlying source data.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → records → Record.
LegalEntity.recordsBrand.recordsWebsite.recordsOperatingLocation.recordsAddress.recordsRole.recordsPhoneNumber.recordsPerson.recordsTin.recordsEmailAddress.recordsRegisteredEntity.records
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
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 |
data |
Data | JSON |
The raw source data for this record as key-value pairs. |
sourceUrl |
Source URL | String |
URL of the upstream dataset this record was sourced from. |
sourceTitle |
Source Title | String |
Title of the upstream dataset this record was sourced from. |
sourceDescription |
Source Description | String |
Description of the upstream dataset this record was sourced from. |
internalId |
String |
A numeric identifier that Enigma assigns to this record object when it builds its data. The value is null for a record that comes only with the UNGROUNDED data layer. |
|
internalRecordId |
String |
A numeric identifier that Enigma assigns to the source record. |
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 |
|---|---|---|
phoneNumbers |
PhoneNumber |
The phone number for a particular business entity. Default first: 100. |
operatingLocations |
OperatingLocation |
An operating location is a place where a business does its work or serves customers, such as one store. Default first: 100. |
brands |
Brand |
A brand is a business as its customers see it, such as a trade name. Default first: 100. |
persons |
Person |
Persons that Enigma associates with this record. Default first: 100. |
addresses |
Address |
A physical street address for the business. Default first: 100. |
roles |
Role |
These are roles which people (and other legal entities) hold at U.S. businesses. Default first: 100. |
legalEntities |
LegalEntity |
Legal entities that Enigma associates with this record. Default first: 100. |
tins |
Tin |
Taxpayer Identification Number (TIN). Default first: 100. |
emailAddresses |
EmailAddress |
An email address for the business or a person associated with the business. Default first: 100. |
websites |
Website |
A website associated with a business. Default first: 100. |
registeredEntities |
RegisteredEntity |
Businesses which have become legal entities by registering with a U.S. Secretary of State (SoS). 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 records(first: 1) { edges { node { id firstObservedDate lastObservedDate rank data } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "records": { "edges": [ { "node": { "id": "000037c8-0002-56d0-0000-0c8000000000", "firstObservedDate": "2026-09-14 01:33:40+00", "lastObservedDate": "2026-09-14 01:33:40+00", "rank": 0, "data": { "DBA Name": "SAFEWAY INC #1714", "District": "22", "Geo Code": "0707", "Mail Zip": "85038-9096", "Prem Zip": "94564", "Fee Codes": "P0", "Mail City": "PHOENIX", "Prem City": "PINOLE", "Dup Counts": " ", "Expir Date": " ", "Lic or App": "APP", "Mail State": "AZ", "Master Ind": "Y", "Prem State": "CA", "File Number": "00194533", "Mail Addr 1": "PO BOX 29096", "Mail Addr 2": "MAIL STOP #6516", "Prem Addr 1": "1421 TARA HILLS DR", "Prem Addr 2": " ", "Prem County": "CONTRA COSTA", "Type Status": "ACTIVE", "License Type": "21", "Primary Name": "SAFEWAY INC", "Type Orig Iss Date": " ", "Prem Census Tract #": "3640.02", "Term in # of Months": "12" …}