- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Subject
Person
A person is an individual linked to a business, such as an owner, an officer, or a registered agent.
Subject. This entity is a subject: a kind of record that a search can start from. Name it in two places: entityType: PERSON in the search input, and ... on Person in the fields you read.
A person is an individual linked to a business, such as an owner, an officer, or a registered agent. A person can also be an instance of a legal entity, as with a sole proprietor.
Fields
Section titled “Fields”| Field | Type | Description |
|---|---|---|
id |
ID! |
The unique ID of the person. |
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 |
String |
Values that order search results with equal match scores. The API does not fill this field 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 |
|---|---|---|
names |
PersonName |
Persons, who may be associated with a business as an owner, officer or contact. Default first: 3. |
legalEntities |
LegalEntity |
The legal entities that this person is an instance of, such as a sole proprietorship. 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. |
websites |
Website |
A website associated with a business. 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.
Where it appears
Section titled “Where it appears”LegalEntity.personsWebsite.personsRecord.persons
Example
Section titled “Example”query { search(searchInput: { entityType: PERSON person: { firstName: "Robert", lastName: "Edwards" } conditions: { limit: 1 } }) { ... on Person { id internalId enigmaId tieBreakerMetadata names(first: 1) { edges { node { fullName } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "b5ccec9f-9870-4fa4-bc98-b0f82adbaaa9", "internalId": null, "enigmaId": null, "tieBreakerMetadata": null, "names": { "edges": [ { "node": { "fullName": "ROBERT EDWARDS" } } ] } } ] }}