AIaiprise
Data (Business)

Business Lookup (Prefill)

Changed on

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

post/data/business/lookup

Request

Request body

business_entity_idstring nullable

Company number / registration number from search result (required for US).

company_idstring nullable

Company identifier from search results. Use this for lookup when returned in search.

country_codestring required

ISO country code.

state_codestring nullable

Optional state code (required for some countries e.g. US).

Response

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

business_infoobject nullable

Example response

{
  "related_companies": [
    {
      "addresses": [
        {
          "full_address": "222 Palm Street, Santa Monica, CA - 93251, US",
          "parsed_address": {
            "address_street_1": "222 Palm Street",
            "address_city": "Santa Monica",
            "address_state": "CA",
            "address_zip_code": "93251",
            "address_country": "US",
            "address_type": "home"
          }
        }
      ]
    }
  ]
}

Changes

  • 74fc7a5199fbRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property //// to the response with the status