---
title: "Prefill business information"
method: POST
path: "/v1/prefill/businesses"
tags: ["prefill"]
---

# Prefill business information

`POST /v1/prefill/businesses`

Smart populate business attributes by searching with name and address, TIN, or website URL. Returns enriched business data.

## Headers

- `Authorization` string, required

## Request body

- object
  - `names` string[] — Business name(s) to search for
  - `addresses` string[] — Business address(es) to search for
  - `tin` string — Taxpayer Identification Number
  - `website_url` string — Business website URL
  - `autocomplete_result_id` string — ID of an autocomplete result to use for direct lookup

## Response `200`

prefill results

- TypePrefillBusiness — Prefilled business information
  - `object` string
  - `names` TypePrefillBusinessNamesItem[] — Business names
    - `name` string
    - `type` 'legal' | 'dba'
  - `addresses` TypePrefillBusinessAddressesItem[] — Business addresses
    - `full_address` string
    - `address_line1` string
    - `address_line2` string, nullable
    - `city` string
    - `state` string
    - `postal_code` string
    - `labels` string[]
  - `tin` TypePrefillBusinessTin — TIN information if verified
    - `last_four` string — Last four digits of the TIN
    - `tin_type` string — Type of TIN (EIN, SSN, etc.)
  - `formation` TypePrefillBusinessFormation — Formation details
    - `entity_type` string, nullable
  - `industry_classifications` TypePrefillBusinessIndustryClassificationsItem[], nullable — Industry classifications
    - `name` string
    - `score` number, double
    - `sector` string, nullable
    - `category` string, nullable
    - `high_risk` boolean
    - `mcc_codes` string[], nullable
    - `sic_codes` string[], nullable
    - `naics_codes` string[], nullable
    - `prohibited_labels` string[]
    - `classification_system` string
  - `people` TypePrefillBusinessPeopleItem[] — Associated persons
    - `name` string
    - `titles` string[]
  - `website` TypePrefillBusinessWebsite — Website information
    - `url` string

## Other responses

- `400` — invalid request - missing required parameters

---

[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/versions/9882e52b445b/schema)