---
title: "Business Prefill"
method: GET
path: "/prefill/businesses"
tags: ["Prefill"]
---

# Business Prefill

`GET /prefill/businesses`

Prefill businesses by searching officer names.
Business name is optional and used only for matching comparison in the response.

## Query parameters

- `officer_name` string, required — Officer name to search
- `business_name` string, nullable — Business name to use for matching comparison (not used for searching)
- `similarity_threshold` number — Similarity threshold for the search (0.0 to 1.0). Defaults to 0.9.
- `limit` integer — Maximum number of results to return

## Response `200`

Successful Response

- V1PrefillRegistrationResponse[]
  - `name` string, required — The name of the registration.
  - `issue_date` string, date, nullable — The date the registration was issued.
  - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS', required
  - `file_number` string, required — The filing number of the registration.
  - `primary_address` V1AddressSummaryResponse — Response model for address summary data. This model defines the structure for address summary API responses.
    - `id` string, uuid, required — Unique identifier for the address.
    - `street` string, required — Street name of the address.
    - `city` string, required — City name of the address.
    - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS', required
    - `zip` string, required — Zip code of the address.
    - `latitude` number, required — Latitude of the address.
    - `longitude` number, required — Longitude of the address.
    - `rdi` 'Residential' | 'Commercial'
    - `deliverable` boolean, nullable — Indicates whether the address is deliverable.
    - `cmra` boolean, nullable — Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).
    - `url` string, uri, nullable — The URL to the address details.
    - `delivery_type` 'FIRM' | 'GENERAL_DELIVERY' | 'HIGH_RISE' | 'POST_OFFICE' | 'RURAL_ROUTE' | 'STREET' — Enum representing the different types of USPS delivery points. Used to classify addresses based on how mail is delivered to them.
  - `officers` string[] — The officers associated with the registration.
  - `alternative_names` string[] — The alternative names associated with the registration.
  - `similarity_score` number, required — The similarity score of the registration.
  - `business_name_match` 'NO_MATCH' | 'SIMILAR' | 'EXACT'

## Other responses

- `422` — Validation Error

---

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