---
title: "Get business verification url"
method: POST
path: "/verify/get_business_verification_url"
tags: ["KYB > Verification (Profile-Based)"]
---

# Get business verification url

`POST /verify/get_business_verification_url`

Endpoint used to get business verification url. Initializes the onboarding SDK & creates a business profile internally.

## Request body

- BusinessVerificationUrlRequest
  - `redirect_uri` string, required — Controls how the onboarding widget signals completion. Pass a reserved keyword — `iframe`, `popup`, `popup_close`, `manual_close`, `react_native`, `flutter`, `ios`, or `android` — to have the widget post the `AiPriseVerification:Complete` message to your host app, or pass a URL to redirect the browser on completion (the session id is appended as `verification_session_id` for KYC or `business_onboarding_session_id` for KYB). See the Redirect modes guide for the full list of behaviors.
  - `template_id` string, required — Every verification must have a template id associated with it. This is Provided to you by AiPrise.
  - `business_profile_id` string — The business profile id to associate with the verification session.
  - `client_reference_id` string — An id you want to associate with your request.
  - `client_reference_data` object — A JSON you want to associate with your request.
  - `callback_url` string
  - `events_callback_url` string
  - `associated_email` string — Email address to associate with the session for later resumption.
  - `business_data` BusinessDataWithPrefillData
    - `name` string — The business name. (Legal name preferred)
    - `alternate_name` string — Alternate business name. (DBA)
    - `tax_identification_number` string — Tax ID
    - `website` string — The business website
    - `formation_date` string — The formation date in YYYY-MM-DD format
    - `country_code` string — A 2-letter ISO country code where business is primarily registered.
    - `state_code` string — State Code of the province/region where business is primarily registered.
    - `business_entity_id` string — Entity ID given by the government to the business.
    - `addresses` Address[] — List of addresses associated with this business
      - `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
    - `phone_numbers` string[] — List of phone numbers associated with this business
    - `email_addresses` string[] — List of email addresses associated with this business
  - `additional_info` BusinessIndividualAdditionalInfo[] — A list of additional information.
    - `additional_info_type` 'BANK_STATEMENT_DOCUMENT' | 'BUSINESS_REGISTRATION_DOCUMENT' | 'OPERATING_LICENSE_DOCUMENT' | 'FRAUD_CHECK_DOCUMENT' | 'ADDRESS_PROOF_DOCUMENT' | 'BANK_ACCOUNT_DETAILS' | 'SOURCE_OF_FUNDS_DOCUMENT' | 'CHAMBER_OF_COMMERCE_CERTIFICATE' | 'CAC_CERTIFICATE' | 'ARTICLES_OF_INCORPORATION' | 'AML_POLICY' | 'FINANCIAL_CONDUCT_AUTHORITY_AUTHORIZATION' | 'DIRECTORS_REGISTRY' | 'CORPORATE_CHART' | 'SHAREHOLDERS_REGISTRY' | 'BALANCE_SHEET' | 'REPORTING_ENTITY_REGISTRATION_DOCUMENT' | 'COMPANY_CONSTITUTION' | 'MEMORANDUM_OF_ASSOCIATION' | 'PARTNERSHIP_DEED' | 'CERTIFIED_ANNUAL_RETURNS_STATEMENT' | 'COMPANY_PROFILE' | 'AUDITED_ACCOUNTS' | 'ANTI_BRIBERY_POLICY' | 'DATA_PROTECTION_POLICY' | 'INVOICE' | 'PEP_FORM' | 'OTHER'
    - `additional_info_data` union
      - string — The additional data as a string.
      - object — The additional data as an object. For file-based types, may include file_data, file_name, file_uuid, and document_input_title.
        - `file_data` string — The file content as base64 or S3 URL.
        - `file_name` string — The name of the file.
        - `file_uuid` string — The unique identifier of the file.
        - `document_input_title` string, nullable — An optional unique identifier for the document input, if provided during document check.
  - `theme_options` ThemeOptions
    - `background` 'light' | 'dark', nullable
    - `color_page` string, nullable
    - `color_brand` string, nullable
    - `color_brand_overlay` string, nullable
    - `font_name` string, nullable
    - `font_weights` string, nullable
    - `button_border_radius` string, nullable
    - `button_padding` string, nullable
    - `button_font_size` string, nullable
    - `button_font_weight` string, nullable
    - `input_border_radius` string, nullable
    - `input_padding` string, nullable
    - `input_font_size` string, nullable
    - `input_font_weight` string, nullable
    - `input_label_font_size` string, nullable
    - `input_label_font_weight` string, nullable
    - `layout_border_radius` string, nullable
    - `modal_border_radius` string, nullable
    - `image_border_radius` string, nullable
  - `verification_options` VerificationOptions
    - `aml_config` object
      - `exact_match` number
      - `fuzziness_score` number
      - `monitoring` boolean
      - `categories_filter` string[]
      - `search_profile` string, nullable
  - `ui_options` ExtendedUIOptionsWithDynamicModules
    - `common` object
      - `default_language` string
    - `dynamic_business_document_module` DynamicBusinessDocumentModule
      - `documents` DynamicDocument[]
        - `subtitle` LanguageMap
          - `en` string
          - `fr` string
          - `it` string
          - `es` string
          - `pt` string
          - `de` string
          - `pl` string
          - `ja` string
          - `ko` string
          - `zh` string
          - `ru` string
          - `ar` string
        - `required` boolean, required
        - `auto_run_check` boolean, required
        - `file_type` 'BANK_STATEMENT_DOCUMENT' | 'BUSINESS_REGISTRATION_DOCUMENT' | 'OPERATING_LICENSE_DOCUMENT' | 'SOURCE_OF_FUNDS_DOCUMENT' | 'ADDRESS_PROOF_DOCUMENT' | 'CHAMBER_OF_COMMERCE_CERTIFICATE' | 'CAC_CERTIFICATE' | 'ARTICLES_OF_INCORPORATION' | 'AML_POLICY' | 'FINANCIAL_CONDUCT_AUTHORITY_AUTHORIZATION' | 'DIRECTORS_REGISTRY' | 'CORPORATE_CHART' | 'SHAREHOLDERS_REGISTRY' | 'BALANCE_SHEET' | 'REPORTING_ENTITY_REGISTRATION_DOCUMENT' | 'COMPANY_CONSTITUTION' | 'MEMORANDUM_OF_ASSOCIATION' | 'PARTNERSHIP_DEED' | 'CERTIFIED_ANNUAL_RETURNS_STATEMENT' | 'COMPANY_PROFILE' | 'AUDITED_ACCOUNTS' | 'ANTI_BRIBERY_POLICY' | 'DATA_PROTECTION_POLICY' | 'FRAUD_CHECK_DOCUMENT' | 'INVOICE' | 'PEP_FORM' | 'TAX_REGISTRATION_DOCUMENT_CONSTANCIA_DE_SITUACION_FISCAL' | 'OTHER', nullable, required
    - `dynamic_business_question_group_module` DynamicBusinessQuestionGroupModule
      - `questions` object — Each key must be a string that matches the pattern /^Q\d{2}$/ (e.g., Q01, Q02, Q99).

## Response `200`

Successful operation

- BusinessVerificationUrlResponse
  - `message` string
  - `verification_url` 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)