A business will have one or many addresses. Middesk geocodes Addresses in all 50 American states, DC, five American territories including AS, GU, MP, PR and VI, Palau, and the Marshall Islands. We also return a variety of details that can be helpful for compliance, fraud, and underwriting decisions.

{
  "object": "address",
  "address_line1": "2180 Bryant St Ste 210",
  "address_line2": null,
  "city": "San Francisco",
  "state": "CA",
  "postal_code": "94110-2141",
  "full_address": "2180 Bryant St Ste 210, San Francisco, CA 94110-2141",
  "latitude": 37.75938,
  "longitude": -122.40994,
  "property_type": "Commercial",
  "cmra": false,
  "deliverable": true,
  "deliverability_analysis": {
        "cmra": "N",
        "active": "Y",
        "vacant": "N",
        "footnotes": "N#",
        "is_ews_match": null,
        "dpv_footnotes": "AABB",
        "dpv_match_code": "Y",
      },
  "sources": [
      {
        "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
        "type": "registration",
        "metadata": {
          "file_number": "C4221590",
          "state": "CA"
        }
      },
      {
        "id": "02c1dcb2-6405-478b-9b94-78c7cbea99",
        "type": "website",
        "metadata": {
          "url": "https://www.middesk.com"
        }
      }
    ],    
  "created_at": "2019-01-30T23:49:01.100Z",
  "updated_at": "2019-01-30T23:49:01.100Z"
}

Attribute

Type

Description

address_line1

string

The street address of the business.

address_line2

string

The second address line typically used for apartment or suite numbers.

city

string

The city of the business

state

string

The state of the business

postal_code

string

The postal code of the business

full_address

string

Display version of address

latitude

float

The latitude of the business address

longitude

float

The longitude of the business address

property_type

string

The type of property known to be located at this address. Possible values are:

  • Commercial (commercial)
  • Residential (residential)

cmra

boolean

Indicates when an address is a Commercial Mail Receiving Agency (CMRA).

deliverable

boolean

A summary of the deliverability of the address

deliverability_analysis

object

A nested object containing the granular details of the deliverability of that address

deliverability_analysis.cmra

string

Indicates when an address is a Commercial Mail Receiving Agency (CMRA).
Possible values are:

  • Y - The address is a CMRA
  • N - The address is not a CMRA

deliverability_analysis.active

string

Indicates whether an address is known to be an active address.
Possible values are:

  • Y - The address is active
  • N - The address is not a active

deliverability_analysis.vacant

string

Indicates whether an address that was once known as deliverable is currently vacant.
Possible values are:

  • Y - The address is active
  • N - The address is not a active

deliverability_analysis.is_ews_match

boolean

Indicates whether an address has been flagged in the Early Warning System. Addresses in EWS are not currently receiving mail but will be shortly.

deliverability_analysis.dpv_footnotes

string

Provides more granular details into how the deliverability of an address was determined.

deliverability_analysis.dpv_match_code

string

Status on the ability to deliver mail to some or part of the provided address. Possible values are:

  • Y — The entire address is deliverable
  • N — The entire address is not deliverable
  • S — The street address is deliverable; however, the unit or suite number is not.
  • D — The street address is deliverable; however, a unit or suite number is expected and was not found.

sources

object []

A nested object containing the source details for each source where a given address was identified

sources[].type

string

The source type for a given address. Possible values are:

  • registration - The address was found based on government registration records
  • website - The address was found on the company website

sources[].metadata

object []

A nested object containing the specific details for each address source.

sources[].metadata.file_number

string

The unique identifier of the Secretary of State record where that address was found

sources[].metadata.state

string

The specific state where that address was found

sources[].metadata.website

string

The domain where that address was found

created_at

timestamp

updated_at

timestamp