---
updatedAt: 2026-10-20T23:12:09.000Z
agentTools:
  projectIndex: https://docs.aiprise.com/llms.txt
---

# Business Lookup (Prefill)

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


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "AiPrise APIs",
    "description": "AiPrise API documentation",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api-sandbox.aiprise.com/api/v1/",
      "description": "Sandbox server"
    },
    {
      "url": "https://api.aiprise.com/api/v1/",
      "description": "Production server"
    }
  ],
  "paths": {
    "/data/business/lookup": {
      "post": {
        "tags": [
          "Data (Business)"
        ],
        "summary": "Business Lookup (Prefill)",
        "description": "Use this API in your SDK to auto-fill business information when a customer onboards, speeding up the onboarding process.\nLookup full business profile by business_entity_id and country.\nReturns registry data only (business_info, registration_info, related_persons, events); no status/result fields.\nMandatory: business_entity_id, country_code. Optional: state_code (required for some countries e.g. US).\n",
        "requestBody": {
          "description": "Lookup by business entity id and country",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyBusinessLookupRequestSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Registry data only; business_info (name, business_entity_id, country_code, formation_date, addresses), registration_info, related_persons, events (no status/result).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataBusinessLookupResultSchema"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ExtractedAddress": {
        "type": "object",
        "properties": {
          "full_address": {
            "type": "string",
            "example": "222 Palm Street, Santa Monica, CA - 93251, US"
          },
          "parsed_address": {
            "type": "object",
            "properties": {
              "address_street_1": {
                "type": "string",
                "example": "222 Palm Street",
                "description": "Address street 1"
              },
              "address_street_2": {
                "type": "string",
                "example": null,
                "description": "Address street 2"
              },
              "address_city": {
                "type": "string",
                "example": "Santa Monica",
                "description": "Address city"
              },
              "address_state": {
                "type": "string",
                "example": "CA",
                "description": "Address state or region"
              },
              "address_zip_code": {
                "type": "string",
                "example": "93251",
                "description": "Address zip code"
              },
              "address_country": {
                "type": "string",
                "example": "US",
                "description": "2-letter address country code"
              },
              "address_type": {
                "type": "string",
                "example": "home",
                "description": "Address type"
              }
            }
          },
          "source": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "file_number": {
                  "type": "string"
                },
                "labels": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "Source information for the address",
            "properties": {
              "type": {
                "type": "string"
              },
              "state": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "file_number": {
                "type": "string"
              },
              "labels": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "additional_info": {
            "type": "object",
            "description": "Additional information about the address (risk indicators, deliverability, etc.)",
            "additionalProperties": {}
          }
        }
      },
      "VerifyBusinessLookupRequestSchema": {
        "type": "object",
        "properties": {
          "business_entity_id": {
            "type": "string",
            "nullable": true,
            "description": "Company number / registration number from search result (required for US)."
          },
          "company_id": {
            "type": "string",
            "nullable": true,
            "description": "Company identifier from search results. Use this for lookup when returned in search."
          },
          "country_code": {
            "type": "string",
            "description": "ISO country code."
          },
          "state_code": {
            "type": "string",
            "nullable": true,
            "description": "Optional state code (required for some countries e.g. US)."
          }
        },
        "required": [
          "country_code"
        ]
      },
      "DataBusinessLookupResultSchema": {
        "type": "object",
        "description": "Registry data only; no status, result, or status_reasons. Data API response.",
        "properties": {
          "business_info": {
            "type": "object",
            "nullable": true
          },
          "related_persons": {
            "type": "array",
            "nullable": true
          },
          "related_companies": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/RelatedCompanyInfo"
            }
          }
        }
      },
      "CompanyRoleDetails": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "start_date": {
            "type": "string",
            "nullable": true
          },
          "end_date": {
            "type": "string",
            "nullable": true
          },
          "is_active": {
            "type": "boolean",
            "nullable": true
          },
          "normalised_name": {
            "$ref": "#/components/schemas/NormalisedRole",
            "nullable": true
          }
        }
      },
      "RelatedCompanyInfo": {
        "type": "object",
        "properties": {
          "company_reference_id": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "country_code": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "addresses": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ExtractedAddress"
            }
          },
          "ownership_percent": {
            "type": "number",
            "nullable": true
          },
          "shares_allocated": {
            "type": "integer",
            "nullable": true
          },
          "alternate_name": {
            "type": "string",
            "nullable": true
          },
          "tax_identification_number": {
            "type": "string",
            "nullable": true
          },
          "formation_date": {
            "type": "string"
          },
          "website": {
            "type": "string",
            "nullable": true
          },
          "state_code": {
            "type": "string",
            "nullable": true
          },
          "business_entity_id": {
            "type": "string",
            "nullable": true
          },
          "roles": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/CompanyRoleDetails"
            }
          },
          "phone_numbers": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            }
          },
          "additional_fields": {
            "nullable": true,
            "type": "object"
          },
          "email_addresses": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            }
          },
          "client_reference_id": {
            "type": "string"
          },
          "client_reference_data": {
            "type": "object"
          },
          "source": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "added_via": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "NormalisedRole": {
        "type": "string",
        "nullable": true,
        "enum": [
          "ULTIMATE_BENEFICIAL_OWNER",
          "CONTROLLING_PERSON",
          "DIRECTOR",
          "LEGAL_REPRESENTATIVE",
          "SHAREHOLDER",
          "EMPLOYEE",
          "UNKNOWN"
        ]
      }
    },
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "description": "All requests must include the `X-API-KEY` header containing your API Key."
      }
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ]
}
```