Autocomplete business names and addresses

The Business Identities Autocomplete API returns real-time, structured autocomplete suggestions based on partial business names. Use it to help users quickly find and select their business during onboarding.

End-to-end flow

1. A user types a partial business name in your application (for example, “dunder”).
2. Your frontend sends a request to Middesk’s POST /v1/identities/autocomplete endpoint using a Publishable API key.
3. Middesk returns a list of structured business identity suggestions including names, addresses, people, and entity type.
4. Your frontend renders the results in the user’s UI.
5. Once a user selects the correct business, send a Smart populate request or Business enrichment Order request to Middesk to retrieve additional business attributes.

Security requirements

To ensure the integrity and appropriate use of this API:

• Publishable API key authentication: Each request must include a Middesk Publishable API key via the Authorization: Bearer header.
• KYC enforcement: Perform KYC checks prior to querying Middesk when possible.
• Abuse prevention: Prevent automated abuse or excessive velocity and volume (for example, bots or scraping).

Integrate the Autocomplete API

Authorization: Bearer <API_KEY>

$
curl -X POST "https://api.middesk.com/v1/identities/autocomplete" \
>
  -H "Authorization: Bearer <PUBLISHABLE API KEY>" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "Dunder Mif",
>
    "entity_type": "CORPORATION",
>
    "addresses": [
>
      {
>
        "address_line1": "1725 Slough Avenue",
>
        "city": "Scranton",
>
        "state": "PA",
>
        "postal_code": "18501"
>
      }
>
    ]
>
  }'

1
{
2
  "data": [
3
    {
4
      "names": [
5
        { "name": "Dunder Mifflin", "type": "legal" },
6
        { "name": "Dunder Mifflinfinity", "type": "dba" }
7
      ],
8
      "addresses": [
9
        {
10
          "full_address": "1725 Slough Avenue, Suite 200, Scranton, PA 18505",
11
          "labels": ["office"]
12
        }
13
      ],
14
      "people": [
15
        { "name": "David Wallace" },
16
        { "name": "Robert Kazamakis" },
17
        { "name": "Jolene Bennett" }
18
      ],
19
      "entity_type": "CORPORATION"
20
    }
21
  ]
22
}

Latency benchmarks

Performance is monitored, and alerts trigger if p95 latency exceeds 300ms over sustained periods.

API reference

Method: POST

URL: https://api.middesk.com/v1/identities/autocomplete

Headers: Include the API key in the Authorization header using Bearer authorization

Request body

Address object

Person object

Response statuses

Response schema

BusinessIdentity object

Name object

Address object (response)

Person object