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

# Business Lookup (Prefill)

`POST /data/business/lookup`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/data/business/lookup`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/data/business/lookup/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.
Lookup full business profile by business_entity_id and country.
Returns registry data only (business_info, registration_info, related_persons, events); no status/result fields.
Mandatory: business_entity_id, country_code. Optional: state_code (required for some countries e.g. US).

## Request body

- VerifyBusinessLookupRequestSchema
  - `business_entity_id` string, nullable: Company number / registration number from search result (required for US).
  - `company_id` string, nullable: Company identifier from search results. Use this for lookup when returned in search.
  - `country_code` string, required: ISO country code.
  - `state_code` string, nullable: Optional state code (required for some countries e.g. US).

## Response `200`

Registry data only; business_info (name, business_entity_id, country_code, formation_date, addresses), registration_info, related_persons, events (no status/result).

- DataBusinessLookupResultSchema: Registry data only; no status, result, or status_reasons. Data API response.
  - `business_info` object, nullable
  - `related_persons` unknown[], nullable
    - unknown
  - `related_companies` RelatedCompanyInfo[], nullable
    - `company_reference_id` string, nullable
    - `name` string, nullable
    - `country_code` string, nullable
    - `status` string, nullable
    - `description` string, nullable
    - `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.)
    - `ownership_percent` number, nullable
    - `shares_allocated` integer, nullable
    - `alternate_name` string, nullable
    - `tax_identification_number` string, nullable
    - `formation_date` string
    - `website` string, nullable
    - `state_code` string, nullable
    - `business_entity_id` string, nullable
    - `roles` CompanyRoleDetails[], nullable
      - `name` string, nullable
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `is_active` boolean, nullable
      - `normalised_name` 'ULTIMATE_BENEFICIAL_OWNER' | 'CONTROLLING_PERSON' | 'DIRECTOR' | 'LEGAL_REPRESENTATIVE' | 'SHAREHOLDER' | 'EMPLOYEE' | 'UNKNOWN', nullable
    - `phone_numbers` string[], nullable
    - `additional_fields` object, nullable
    - `email_addresses` string[], nullable
    - `client_reference_id` string
    - `client_reference_data` object
    - `source` string[]
    - `added_via` string, nullable

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `74fc7a5199fb`: 2 info
  - added the optional property `related_companies/items/added_via` to the response with the `200` status
  - added the optional property `related_companies/items/roles/items/normalised_name` to the response with the `200` status

[Operation history](https://skmtc.dev/aiprise/apis/aiprise-apis/changes/data/business/lookup/post.md)

---

[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)