Address

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,
  "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"` `"RESIDENTIAL"`
cmra	`boolean`	Indicates when an address is a Commercial Mail Receiving Agency (CMRA).
deliverable	`boolean`	A summary of the deliverability of the address
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 `profile` - The address was found on the company's facebook or google profile
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`

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). FMCSA data will appear in the "sources" field when the business address can be found in their database. This feature is enabled by default but is an optional feature that can be turned off from the settings page of your account.

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

NPPES NPI Registry Data

🚧
NPPES NPI Registry Data Enablement
As a supplementary data point for business address verification, we have added the ability to search and match against data from the National Provider Identifier (NPI) registry, which HIPAA-covered entities are required to register with. NPI registry data will appear in the "sources" field when found. Note this is an optional feature that is enabled by default but can be turned off from the settings page of your account.

NPI Record Address Match JSON Response:

"addresses": [{
  "object": "address",
  "address_line1": "85 Second Street",
  "address_line2": null,
  "city": "San Francisco",
  "state": "CA",
  "postal_code": "94105-3459",
  "full_address": "85 Second Street, San Francisco, CA 94105-3459",
  "submitted": true,
  "id": "f15e4ce9-109b-4a88-9540-5890ca511c2d",
  "latitude": 39.09271,
  "longitude": -104.87254,
  "property_type": "COMMERCIAL",
  "deliverable": true,
  "deliverability_analysis": null,
  "street_view_available": null,
  "labels": [],
  "created_at": "2023-02-14T21:12:45.085Z",
  "updated_at": "2023-02-14T21:12:45.085Z",
  "registered_agent_name": null,
  "cmra": null,
  "business_id": "80556c5c-74d1-4e9c-91b8-9fe149338bef",
  "sources": [
    {
      "id": "45fdfb94-7b45-402e-a3a6-2558b89fddac",
      "type": "npi_record",
      "metadata": {
        "id": "1033531256",
        "source_data": [
          {
            "name": "Business Name",
            "value": "Middesk Inc"
          },
          {
            "name": "National Provider Identifier (NPI)",
            "value": "1234567890"
          },
          {
            "name": "Primary Practice Address",
            "value": "85 Second Street, San Francisco, CA 94105-3459"
          },
          {
            "name": "Mailing Address",
            "value": "85 Second Street, San Francisco, CA 94105-3459"
          },
          {
            "name": "Secondary Practice Address",
            "value": []
          },
          {
            "name": "Enumeration Date",
            "value": "2014-01-07"
          }
        ],
        "source_data_link": "https://npiregistry.cms.hhs.gov/provider-view/1234567890"
      }
    }
  ]
},
...