Skip to content
Console(opens in a new tab)

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.

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.

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.

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