- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Subject
LegalEntity
A legal entity is a business as a government recognizes it, for taxes, compliance, and legal accountability.
Subject. This entity is a subject: a kind of record that a search can start from. Name it in two places: entityType: LEGAL_ENTITY in the search input, and ... on LegalEntity in the fields you read.
A legal entity is a business as a government recognizes it, for taxes, compliance, and legal accountability. One legal entity can do business as several brands and can own many operating locations.
Fields
Section titled “Fields”| Field | Type | Description |
|---|---|---|
id |
ID! |
The unique ID of the legal entity. |
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. |
enigmaId |
String |
An optional identifier that Enigma assigns to this object when custom identification is applicable. |
tieBreakerMetadata |
LegalEntityTieBreakerMetadata |
Values that order search results with equal match scores. The API does not fill these values today. |
searchMetadata |
Searchmetadata |
Match details that show how this result matched each search input. The API does not fill these details today. |
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 |
|---|---|---|
brands |
Brand |
The brands that this legal entity does business as. Default first: 100. |
names |
LegalEntityName |
A legal entity is an entity which U.S. law recognizes as having an identity and rights. Default first: 3. |
verificationTiers |
VerificationTier |
A verification tier groups the verification evidence that Enigma has for a legal entity, together with the signals that set the tier. Default first: 3. |
roles |
Role |
These are roles which people (and other legal entities) hold at U.S. businesses. Default first: 100. |
persons |
Person |
The persons that are instances of this legal entity, such as the owner of a sole proprietorship. Default first: 100. |
registeredEntities |
RegisteredEntity |
Businesses which have become legal entities by registering with a U.S. Secretary of State (SoS). Default first: 100. |
tins |
Tin |
Taxpayer Identification Number (TIN). Default first: 100. |
operatingLocations |
OperatingLocation |
The operating locations that this legal entity owns. Default first: 100. |
isFlaggedByWatchlistEntries |
WatchlistEntry |
A watchlist entry for the entity. Default first: 100. |
appearsOnWatchlistEntries |
WatchlistEntry |
A watchlist entry for the entity. Default first: 100. |
addresses |
Address |
A physical street address for the business. Default first: 100. |
legalEntities |
LegalEntity |
Other legal entities affiliated with this legal entity. Each edge carries the affiliationType. 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. |
ownsBrands |
Brand |
The brands that this legal entity owns. Default first: 100. |
licensesBrands |
Brand |
The brands that this legal entity licenses. Default first: 100. |
types |
LegalEntityType |
A legal entity is an entity which U.S. law recognizes as having an identity and rights. Default first: 3. |
bankruptcies |
LegalEntityBankruptcy |
The bankruptcy filing of the legal entity. Default first: 3. |
isMentionedInMediaContents |
MediaContent |
Media coverage associated with an entity, including news mentions, press coverage, and news stories published across various news sources and platforms. |
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.
Where it appears
Section titled “Where it appears”LegalEntity.legalEntitiesBrand.legalEntitiesBrand.legalEntitiesOwnsBrand.legalEntitiesLicensesOperatingLocation.legalEntitiesAddress.legalEntitiesRole.legalEntitiesRecord.legalEntitiesPerson.legalEntitiesTin.legalEntitiesRegisteredEntity.legalEntitiesWatchlistEntry.legalEntitiesIsFlaggedByWatchlistEntry.legalEntitiesAppearsOn
Example
Section titled “Example”query { search(searchInput: { entityType: LEGAL_ENTITY name: "Safeway Inc" conditions: { limit: 1 } }) { ... on LegalEntity { id internalId enigmaId names(first: 1) { edges { node { name } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "9691af21-d824-4e89-9aee-28c6ad410968", "internalId": null, "enigmaId": null, "names": { "edges": [ { "node": { "name": "SAFEWAY, INC." } } ] } } ] }}