- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Subject
Address
A physical street address for the business.
Subject. This entity is a subject: a kind of record that a search can start from. Name it in two places: entityType: ADDRESS in the search input, and ... on Address in the fields you read.
The address is a physical street address for the business. We conform to the standards provided by USPS Publication 28 where possible.
If information is available we indicate the specific street address and unit. This means that two units in the same building appear as two distinct addresses. Otherwise, the address may be a postal code or city/state rather than a complete street address.
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
fullAddress |
Full Address | String |
The complete address including street address, unit, city, state and ZIP code. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
streetAddress1 |
Street Address 1 | String |
The main street address with number, name, and directionals using USPS standards. |
streetAddress2 |
Street Address 2 | String |
Additional address information like unit, suite or floor number using USPS abbreviations. |
city |
City | String |
The city where this address is located. |
state |
State | String |
The two-letter abbreviation of the U.S. state or territory. |
zip |
ZIP Code | String |
The current five-digit U.S. postal code of the address. |
firstObservedDate |
First Observed Date | String |
The first date on which Enigma observed this address. |
lastObservedDate |
Last Observed Date | String |
The most recent date on which Enigma observed this address. |
county |
County | String |
The county where this address is located. |
msa |
Metropolitan Statistical Area | String |
The Metropolitan/Micropolitan Statistical Area where this address is located. |
csa |
Combined Statistical Area | String |
The Combined Statistical Area where this address is located. |
latitude |
Latitude | Float |
The approximate latitude (decimal form) of the street address. |
longitude |
Longitude | Float |
The approximate longitude (decimal form) of the street address. |
h3Index |
H3 Index | String |
The h3 index (resolution 10) for geo-hashing applications. |
country |
Country | String |
The three-digit ISO3 country code, null typically indicates USA. |
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. |
|
internalAddressId |
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. |
|
id |
ID | ID |
The unique ID of the address. |
operatingLocationOperatesAtCount |
Int |
The number of distinct operating locations that operate at this address. | |
legalEntityReceivesMailAtCount |
Int |
The number of distinct legal entities that receive mail at this address. Legal entities that represent a person are not in this count. associatedPersonCount counts persons. |
|
associatedBrandCount |
Int |
The number of distinct brands that operate at this address through an operating location. This set is different from the set of brandViaLegalEntityCount. A brand can be in one set, in both, or in neither. |
|
registrationRecordedCount |
Int |
The number of distinct registrations recorded at this address. The count includes only registrations that record this address as a mailing address. | |
associatedPersonCount |
Int |
The number of distinct persons linked to this address through its legal entities. A person linked only through a role at an operating location or through a registration at this address is not in this count. | |
legalEntityViaRegistrationCount |
Int |
The number of distinct legal entities named as the registered entity on a registration at this address. The count includes only registrations that record this address as a mailing address. This set is different from the set of legalEntityReceivesMailAtCount. |
|
brandViaLegalEntityCount |
Int |
The number of distinct brands that a business legal entity at this address does business as, owns, or licenses. The legal entity receives mail at this address or is on a mailing registration here. brandViaPersonLegalEntityCount counts the brands of legal entities that represent a person. |
|
brandViaPersonLegalEntityCount |
Int |
The number of distinct brands that a legal entity which represents a person, such as a sole proprietor, does business as, owns, or licenses. The legal entity links to this address as for brandViaLegalEntityCount. |
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 |
|---|---|---|
operatingLocations |
OperatingLocation |
The operating locations that operate at this address. Default first: 100. |
registrations |
Registration |
Business registrations filed with a Secretary of State (or equivalent) in a U.S. state or territory. Default first: 100. |
deliverabilities |
AddressDeliverability |
The delivery properties of an address. Default first: 3. |
watchlistEntries |
WatchlistEntry |
A watchlist entry for the entity. Default first: 100. |
legalEntities |
LegalEntity |
The legal entities that receive mail at this address. 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. |
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.addressesOperatingLocation.addressesRegistration.addressesRecord.addressesWatchlistEntry.addresses
Example
Section titled “Example”query { search(searchInput: { entityType: ADDRESS address: { street1: "5918 Stoneridge Mall Rd", city: "Pleasanton", state: "CA" } conditions: { limit: 1 } }) { ... on Address { id fullAddress rank streetAddress1 } }}Response, as returned:
{ "data": { "search": [ { "id": "563bb589-43fe-444e-b909-39ac87d16af0", "fullAddress": "5918 STONERIDGE MALL RD PLEASANTON CA 94588", "rank": 0, "streetAddress1": "5918 STONERIDGE MALL RD" } ] }}