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 MathFunctions {
  fullAddress: String
  id: UUID!
  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
  internalId: String
  internalAddressId: String
  operatingLocations(
    first: Int = 100
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressOperatingLocationConnection
  registrations(
    first: Int = 100
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressRegistrationConnection
  deliverabilities(
    first: Int = 3
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressDeliverabilityConnection
  watchlistEntries(
    first: Int = 100
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressWatchlistEntryConnection
  legalEntities(
    first: Int = 100
    last: Int
    after: String
    before: String
    conditions: ConnectionConditions
  ): AddressLegalEntityConnection
  count(
    field: String!
    conditions: Conditions
  ): Int
  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
}

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.id` ● `UUID!` non-null scalar

`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.