Skip to content
Console(opens in a new tab)

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.

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.

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.

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