---
title: "Autocomplete business identities"
method: POST
path: "/v1/identities/autocomplete"
tags: ["identities"]
---

# Autocomplete business identities

`POST /v1/identities/autocomplete`

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

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string, required — Business name to search for (minimum 3 characters)
  - `entity_type` 'LLC' | 'CORPORATION' | 'NON_PROFIT' | 'PARTNERSHIP' | 'TRUST' — Entity type filter
  - `addresses` TypeIdentitiesBusinessIdentityRequestParamAddressesItem[] — Address filters
    - `address_line1` string
    - `city` string
    - `state` string
    - `postal_code` string

## Response `200`

autocomplete results

- TypeBusinessIdentityList — List of business identity autocomplete results
  - `data` TypeBusinessIdentity[]
    - `id` string — Unique identifier for this autocomplete result
    - `names` TypeBusinessIdentityNamesItem[] — Business names (legal or DBA)
      - `name` string
      - `type` 'legal' | 'dba'
    - `addresses` TypeBusinessIdentityAddressesItem[] — Known business addresses
      - `full_address` string
      - `address_line1` string
      - `address_line2` string, nullable
      - `city` string
      - `state` string
      - `postal_code` string
      - `labels` string[]
    - `people` TypeBusinessIdentityPeopleItem[] — Associated persons
      - `name` string
      - `titles` string[]
    - `entity_type` 'LLC' | 'CORPORATION' | 'NON_PROFIT' | 'PARTNERSHIP' | 'TRUST' — Business entity type

## Other responses

- `422` — invalid request - name too short

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/revisions/f849b82a42e1/schema)