---
title: "Business Search (Prefill)"
method: POST
path: "/data/business/search"
tags: ["Data (Business)"]
---

# Business Search (Prefill)

`POST /data/business/search`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/data/business/search`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/data/business/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this API in your SDK to auto-fill business information when a customer onboards, speeding up the onboarding process. Search businesses by name. Returns matches with standard business_info (name, business_entity_id, state_code, etc.).Returns registry data only — no verification is performed.Requires X-API-KEY header.Mandatory: name, country_code. Optional: state_code.

## Request body

- VerifyBusinessSearchRequestSchema
  - `name` string, required: Business name to search.
  - `country_code` string, required: ISO country code (e.g. US, GB).
  - `state_code` string, nullable: Optional state/region code (e.g. for US).

## Response `200`

Wrapped list; results array and total_count. Each item has business_info (name, business_entity_id, entity_type, country_code, state_code, addresses).

- DataBusinessSearchResultSchema: Wrapped search response; results and total_count.
  - `results` DataBusinessSearchResultItemSchema[]
    - `business_info` object
      - `name` string, nullable
      - `business_entity_id` string, nullable
      - `country_code` string, nullable
      - `state_code` string, nullable
      - `company_id` string, nullable: Company identifier returned in search results. Use this for subsequent lookup calls when present.
      - `addresses` ExtractedAddress[], nullable
        - `full_address` string
        - `parsed_address` object
          - `address_street_1` string: Address street 1
          - `address_street_2` string: Address street 2
          - `address_city` string: Address city
          - `address_state` string: Address state or region
          - `address_zip_code` string: Address zip code
          - `address_country` string: 2-letter address country code
          - `address_type` string: Address type
        - `source` object[]: Source information for the address
          - `type` string
          - `state` string
          - `status` string
          - `file_number` string
          - `labels` string[]
        - `additional_info` object: Additional information about the address (risk indicators, deliverability, etc.)
  - `total_count` integer: Number of items in results.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/aiprise/apis/aiprise-apis.md) - [All operations](https://skmtc.dev/aiprise/apis/aiprise-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/aiprise/apis/aiprise-apis/revisions/74fc7a5199fb?raw)