Skip to main content

Address

Description​

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.

type Address implements NodeFunctions {
  fullAddress: String
  rank: Int
  streetAddress1: String
  streetAddress2: String
  city: String
  state: String
  zip: String
  firstObservedDate: String
  lastObservedDate: String
  county: String
  msa: String
  csa: String
  latitude: Float
  longitude: Float
  h3Index: String
  country: String
  recordCount: String
  recordSources: JSON
  recordTags: JSON
  recordTagCounts: JSON
  recordSourceCounts: JSON
  internalId: String
  internalAddressId: String
  id: ID
  operatingLocations(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressOperatingLocationConnection
  registrations(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressRegistrationConnection
  deliverabilities(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressDeliverabilityConnection
  watchlistEntries(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressWatchlistEntryConnection
  legalEntities(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressLegalEntityConnection
  childAddresses(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressConnection
  parentAddresses(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressConnection
  records(
    first: Int
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): RecordConnection
  count(
    field: String!
    conditions: Conditions
  ): Int
  countDistinct(
    field: String!
    conditions: Conditions
  ): Int
  has(
    field: String!
    conditions: Conditions
  ): Boolean
  sum(
    field: String!
    conditions: Conditions
  ): Int
  min(
    field: String!
    conditions: Conditions
  ): Int
  max(
    field: String!
    conditions: Conditions
  ): Int
  avg(
    field: String!
    conditions: Conditions
  ): Float
  collect(
    field: String!
    separator: String
    conditions: Conditions
  ): String
  minDateTime(
    field: String!
    conditions: Conditions
  ): DateTime
  maxDateTime(
    field: String!
    conditions: Conditions
  ): DateTime
  _fn: JSON
  operatingLocationOperatesAtCount: Int
  legalEntityReceivesMailAtCount: Int
  associatedBrandCount: Int
  registrationRecordedCount: Int
  associatedPersonCount: Int
  legalEntityViaRegistrationCount: Int
  brandViaLegalEntityCount: Int
  brandViaPersonLegalEntityCount: Int
}

Fields​

Address.fullAddress ● String scalar​

The complete address including street address, unit, city, state and ZIP code. The full_address field is rendered without punctuation.

So for example "1223 18 MILE RD, STERLING HEIGHTS, MI 48314" becomes "1223 18 MILE RD STERLING HEIGHTS MI 48314".

Address.rank ● Int scalar​

Determines the display order of the attribute, with lower values shown first

Address.streetAddress1 ● String scalar​

Typically consists of a street number, street name, street type abbreviation, and, if available, abbreviated pre or post directionals. Where a streets has multiple names we attempt to provide the one indicated as the USPS standard.

Address.streetAddress2 ● String scalar​

Contains any additional address information such as the unit, suite or floor number, or other information. We present this using USPS standard abbreviations.

Address.city ● String scalar​

The city where this address is located.

Address.state ● String scalar​

The two-letter abbreviation of the U.S. state or territory.

Address.zip ● String scalar​

The five-digit U.S. postal code of the address. If the address information pertains to an earlier period when a different postal code was used, we provide the postal code that is **currently** used.

Address.firstObservedDate ● String scalar​

Address.lastObservedDate ● String scalar​

Address.county ● String scalar​

The county where this address is located.

Address.msa ● String scalar​

The Metropolitan/Micropolitan Statistical Area where this address is located.

Address.csa ● String scalar​

The Combined Statistical Area where this address is located.

Address.latitude ● Float scalar​

The approximate latitude (decimal form) of the street address. We do not provide latitudes for all addresses.

Address.longitude ● Float scalar​

The approximate longitude (decimal form) of the street address. We do not provide longitudes for all addresses.

Address.h3Index ● String scalar​

The h3 index (resolution 10) corresponding to the latitude and longitude. We provide this as a convenience for geo-hashing applications.

Address.country ● String scalar​

The three-digit ISO3 country code. We provide a country code where can unambiguously identify the country. Where the country code is null, it can generally be inferred that the address is located in the USA.

Address.recordCount ● String scalar​

Total number of upstream source records (e.g. government filings, business registrations, third-party database records) linked to this address.

Address.recordSources ● JSON scalar​

Distinct titles of the upstream datasets from which the linked records were sourced.

Address.recordTags ● JSON scalar​

Distinct tags (regulatory level, filing type, subject domain, geography) across all linked records.

Address.recordTagCounts ● JSON scalar​

Map of tag to the number of linked records carrying that tag.

Address.recordSourceCounts ● JSON scalar​

Map of source dataset title to the number of linked records from that dataset.

Address.internalId ● String scalar​

Address.internalAddressId ● String scalar​

Address.id ● ID scalar​

Address.operatingLocations ● AddressOperatingLocationConnection object​

Address.operatingLocations.first ● Int scalar​
Address.operatingLocations.last ● Int scalar​
Address.operatingLocations.after ● String scalar​
Address.operatingLocations.before ● String scalar​
Address.operatingLocations.conditions ● ConnectionConditions input​

Address.registrations ● AddressRegistrationConnection object​

Address.registrations.first ● Int scalar​
Address.registrations.last ● Int scalar​
Address.registrations.after ● String scalar​
Address.registrations.before ● String scalar​
Address.registrations.conditions ● ConnectionConditions input​

Address.deliverabilities ● AddressDeliverabilityConnection object​

Address.deliverabilities.first ● Int scalar​
Address.deliverabilities.last ● Int scalar​
Address.deliverabilities.after ● String scalar​
Address.deliverabilities.before ● String scalar​
Address.deliverabilities.conditions ● ConnectionConditions input​

Address.watchlistEntries ● AddressWatchlistEntryConnection object​

Address.watchlistEntries.first ● Int scalar​
Address.watchlistEntries.last ● Int scalar​
Address.watchlistEntries.after ● String scalar​
Address.watchlistEntries.before ● String scalar​
Address.watchlistEntries.conditions ● ConnectionConditions input​

Address.legalEntities ● AddressLegalEntityConnection object​

Address.legalEntities.first ● Int scalar​
Address.legalEntities.last ● Int scalar​
Address.legalEntities.after ● String scalar​
Address.legalEntities.before ● String scalar​
Address.legalEntities.conditions ● ConnectionConditions input​

Address.childAddresses ● AddressConnection object​

Address.childAddresses.first ● Int scalar​
Address.childAddresses.last ● Int scalar​
Address.childAddresses.after ● String scalar​
Address.childAddresses.before ● String scalar​
Address.childAddresses.conditions ● ConnectionConditions input​

Address.parentAddresses ● AddressConnection object​

Address.parentAddresses.first ● Int scalar​
Address.parentAddresses.last ● Int scalar​
Address.parentAddresses.after ● String scalar​
Address.parentAddresses.before ● String scalar​
Address.parentAddresses.conditions ● ConnectionConditions input​

Address.records ● RecordConnection object​

Address.records.first ● Int scalar​
Address.records.last ● Int scalar​
Address.records.after ● String scalar​
Address.records.before ● String scalar​
Address.records.conditions ● ConnectionConditions input​

Address.count ● Int scalar​

Address.count.field ● String! non-null scalar​
Address.count.conditions ● Conditions input​

Address.countDistinct ● Int scalar​

Address.countDistinct.field ● String! non-null scalar​
Address.countDistinct.conditions ● Conditions input​

Address.has ● Boolean scalar​

Address.has.field ● String! non-null scalar​
Address.has.conditions ● Conditions input​

Address.sum ● Int scalar​

Address.sum.field ● String! non-null scalar​
Address.sum.conditions ● Conditions input​

Address.min ● Int scalar​

Address.min.field ● String! non-null scalar​
Address.min.conditions ● Conditions input​

Address.max ● Int scalar​

Address.max.field ● String! non-null scalar​
Address.max.conditions ● Conditions input​

Address.avg ● Float scalar​

Address.avg.field ● String! non-null scalar​
Address.avg.conditions ● Conditions input​

Address.collect ● String scalar​

Address.collect.field ● String! non-null scalar​
Address.collect.separator ● String scalar​
Address.collect.conditions ● Conditions input​

Address.minDateTime ● DateTime scalar​

Address.minDateTime.field ● String! non-null scalar​
Address.minDateTime.conditions ● Conditions input​

Address.maxDateTime ● DateTime scalar​

Address.maxDateTime.field ● String! non-null scalar​
Address.maxDateTime.conditions ● Conditions input​

Address._fn ● JSON scalar​

Address.operatingLocationOperatesAtCount ● Int scalar​

Distinct operating locations that operate at this address.

Address.legalEntityReceivesMailAtCount ● Int scalar​

Distinct legal entities that receive mail at this address, excluding person-instance legal entities (see associatedPersonCount for those).

Address.associatedBrandCount ● Int scalar​

Distinct brands operating (via an operating location) at this address. This is a DIFFERENT set from brandViaLegalEntityCount (brands reached via a legal entity's DBA relationship) -- a brand can appear in one, the other, both, or neither.

Address.registrationRecordedCount ● Int scalar​

Distinct registrations recorded at this address. NOTE: registration_recorded_address is filtered to address_type == 'mailing', so this undercounts if non-mailing registrations should count too.

Address.associatedPersonCount ● Int scalar​

Distinct persons associated with this address via legalEntities.persons only. NOTE: this is one of (at least) three paths from Address to Person -- persons reachable only via a role performed at an operating location or registration recorded at this address are not counted, so this undercounts the true total.

Address.legalEntityViaRegistrationCount ● Int scalar​

Distinct legal entities reached via registrations.registeredEntities.legalEntities -- i.e. a legal entity named as the registered entity on a registration recorded at this address. This is a DIFFERENT set from legalEntityReceivesMailAtCount (the direct receives-mail-at edge): a legal entity can appear in one, the other, both, or neither, so callers wanting every legal entity associated with this address need to union both today. NOTE: inherits registrations' own address_type == 'mailing' filter, which excludes roughly 80% of registration-address rows (registered_agent/officer/registered/site/headquarters), so this undercounts the true total the same way registrationRecordedCount does.

Address.brandViaLegalEntityCount ● Int scalar​

Distinct brands reached via a business-type (non-person-instance) legal entity's does-business-as, owns, or licenses relationship to a brand, where the legal entity is associated with this address via legalEntities (receives-mail-at) or legalEntityViaRegistrationCount's mailing-registration path. This is a DIFFERENT set from associatedBrandCount (brands via an operating location) and from brandViaPersonLegalEntityCount (the person-instance equivalent) -- a brand can appear in any combination of the three. NOTE: inherits the same mailing-only registration filter as legalEntityViaRegistrationCount, so this undercounts the true total the same way.

Address.brandViaPersonLegalEntityCount ● Int scalar​

Distinct brands reached via a person-instance legal entity's does-business-as, owns, or licenses relationship to a brand (e.g. a sole proprietor who directly owns/licenses a DBA brand) -- same association paths and mailing-registration filter as brandViaLegalEntityCount, but scoped to person-instance legal entities instead of business-type ones. This is a DIFFERENT set from associatedBrandCount and brandViaLegalEntityCount -- a brand can appear in any combination of the three.

Interfaces​

NodeFunctions interface​

Member Of​

AddressEdge object ● LegalEntityAddressEdge object ● OperatingLocationAddressEdge object ● RegistrationAddressEdge object ● WatchlistEntryAddressEdge object

Implemented By​

SearchUnion union

Last updated on