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

# Business Lookup (Autofill)

`POST /data/business/lookup`

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, 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
    - `phone_numbers` string[], nullable
    - `additional_fields` object, nullable
    - `email_addresses` string[], nullable
    - `client_reference_id` string
    - `client_reference_data` object
    - `source` string[]

## Other responses

- `400` — Bad Request

---

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