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"
}
AttributeTypeDescription
address_line1stringThe street address of the business.
address_line2 stringThe second address line typically used for apartment or suite numbers.
city stringThe city of the business
state stringThe state of the business
postal_code stringThe postal code of the business
full_address stringDisplay version of address
latitude floatThe latitude of the business address
longitude floatThe longitude of the business address
property_typestringThe type of property known to be located at this address. Possible values are:
"COMMERCIAL"
"RESIDENTIAL"
cmrabooleanIndicates when an address is a Commercial Mail Receiving Agency (CMRA).
deliverablebooleanA summary of the deliverability of the address
deliverability_analysisobjectA nested object containing the granular details of the deliverability of that address
deliverability_analysis.cmrastringIndicates 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.activestringIndicates 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.vacantstringIndicates 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_matchbooleanIndicates 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_footnotesstringProvides more granular details into how the deliverability of an address was determined.
deliverability_analysis.dpv_match_codestringStatus 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.
sourcesobject []A nested object containing the source details for each source where a given address was identified
sources[].typestringThe 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
profile - The address was found on the company's facebook or google profile
sources[].metadataobject []A nested object containing the specific details for each address source.
sources[].metadata.file_numberstringThe unique identifier of the Secretary of State record where that address was found
sources[].metadata.statestringThe specific state where that address was found
sources[].metadata.websitestringThe domain where that address was found
created_attimestamp
updated_attimestamp

FMCSA Registrations

🚧

FMCSA Registrations Enablement

As a supplementary data point for business address verification, we have added the ability to search and match against the FMCSA (Federal Motor Carrier Safety Administration). This feature is enabled by default; therefore, the FMCSA will appear in the "source" field for cases where the business address can be found through their database (reference the sample JSON response below for the full mapping). Note this is an optional feature that can be turned off by reaching out to your Account Manager or to [email protected]

FMCSA Address Match JSON Response:

{
    ...
    "fmcsa_registrations": [{
      "id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
      "object": "fmcsa_registration",
      "dot_number": "2948750",
      "legal_name": "John Doe",
      "dba_name": "John Doe's Donuts",
      "addresses": [
            "123 Street, HOUSTON, TX 77008"
        ],
        "source": "<link>"
    }],
    "addresses": [{
      "object": "address",
      "address_line1": "100 Blvd Unit 123",
      "address_line2": null,
      "city": "Atlanta",
      "state": "GA",
      "postal_code": "30341-2872",
      "full_address": "5100 Blvd Unit 123",
      "submitted": true,
      "id": "7611e1be-6dc8-4fef-84a1-29027f45d6a8",
      "latitude": 33.88864519592745,
      "longitude": -84.31442417935,
      "property_type": "RESIDENTIAL",
      "deliverable": true,
      "deliverability_analysis": null,
      "street_view_available": true,
      "labels": [],
      "created_at": "2022-07-15T13:57:25.802Z",
      "updated_at": "2022-07-15T13:57:26.660Z",
      "registered_agent_name": null,
      "cmra": null,
      "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
      "sources": [{
          "id": "be7afda5-a37c-4e30-baef-22a97c50366b",
          "type": "fmcsa_registration",
          "metadata": {
            "dot_number": "2948750"
          }
        }
    }]
}