- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
Registration
Business registrations filed with a Secretary of State (or equivalent) in a U.S. state or territory.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
Business registrations filed with a Secretary of State (or equivalent) in a U.S. state or territory. These registrations either create a legal entity in that state (“domestic” registrations) or allow an existing entity to do business in that state (“foreign” registrations). They are a source of truth about that business.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → roles → Role → registrations → Registration.
Address.registrationsRole.registrationsRegisteredEntity.registrations
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this registration. 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. |
registrationType |
Registration Type | String |
The legal form of the registered entity, as given by the regististering jurisdiction’s Secretary of State. |
expirationDate |
Expiration Date | Date |
The registration’s expiration, if any. |
registrationState |
Jurisdiction State | String |
The US state where the registration was filed. |
jurisdictionType |
Jurisdiction Type | String |
foreign if the registration is for any state other than the business’s home state. |
homeJurisdictionState |
Home Jurisdiction State | String |
Two-letter abbreviation for the state jurisdiction of the business. |
registeredName |
Registered Name | String |
Business name as on the registration filing. |
fileNumber |
File Number | String |
File number of the registration filing. |
issueDate |
Issue Date | Date |
Issue date of the registration filing, formatted YYYY/MM/DD. |
status |
Status | String |
Status field indicating whether the registration is active or inactive. |
subStatus |
Sub-Status | String |
If available from the state, a normalized sub-status for the business. |
statusDetail |
Status Detail | String |
If available, the official filing status message provided by the state. |
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. |
|
internalRegistrationId |
String |
A numeric identifier that Enigma assigns to the registration when it builds its data. All Registration objects for one registration share this value. |
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 |
|---|---|---|
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. |
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 roles(first: 1) { edges { node { registrations(first: 1) { edges { node { id rank firstObservedDate lastObservedDate registrationType } } } } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "roles": { "edges": [ { "node": { "registrations": { "edges": [] } } } ] } } ] }}