Autocomplete business identities

import requests
url = "https://api.middesk.com/v1/identities/autocomplete"
payload = { "name": "Dunder Mifflin" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": [
    {
      "names": [
        {
          "name": "Dunder Mifflin Paper Company, Inc.",
          "type": "legal"
        }
      ],
      "addresses": [
        {
          "full_address": "1725 Slough Ave, Scranton, PA 18503",
          "address_line1": "1725 Slough Ave",
          "city": "Scranton",
          "state": "PA",
          "postal_code": "18503",
          "labels": [
            "headquarters"
          ]
        }
      ],
      "people": [
        {
          "name": "Michael Scott",
          "titles": [
            "Regional Manager"
          ]
        }
      ],
      "entity_type": "CORPORATION"
    }
  ]
}

Search for business identities using partial name matching. Returns matching businesses with names, addresses, people, and entity type.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

Business name to search for (minimum 3 characters)

entity_typeenumOptional

Entity type filter

Allowed values:

addresseslist of objectsOptional

Address filters

Response

autocomplete results

datalist of objects or null

Authentication

Request

Response

Errors