---
title: "Update Related Company V2"
method: PUT
path: "/verify/related_company_v2"
tags: ["KYB > Related Entities V2 (Recommended)"]
---

# Update Related Company V2

`PUT /verify/related_company_v2`

Update a related company's information using the V2 format

## Request body

- UpdateRelatedCompanyV2RequestSchema
  - `business_profile_id` string, required — The business profile ID
  - `company_reference_id` string, required — The company reference ID to update
  - `business_profile` BusinessProfileInputOnly, required
    - `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_information` CreateBusinessProfileAdditionalInfoItem[] — - For each item in this list: - If `additional_info_type` is a `File/Document`, then `additional_info_data` MUST be an object and MUST contain a required property `file_data`. Some specific file types may also require additional properties. - Otherwise, `additional_info_data` MAY be a string.
      - `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 — Used when additional_info_type is not a File/Document.
        - object
          - `file_data` string, required — The file data (base64) associated with this additional info.
    - `client_reference_id` string — An id you want to associate with the business profile.
    - `client_reference_data` object — A JSON you want to associate with the business profile.
    - `callback_url` string
    - `events_callback_url` string
    - `tags` string[] — List of tag names associated with this business profile
  - `ownership_percent` number, nullable — Percentage of ownership in the business
  - `shares_allocated` integer, nullable — Number of shares allocated to this company
  - `roles` CompanyRoleDetails[] — List of roles held by this company in the business
    - `name` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `is_active` boolean, nullable
  - `additional_fields` object — Additional custom fields for the relationship
  - `relationship_type` 'PARENT' | 'CHILD' | 'SIBLING' | 'UNKNOWN', nullable

## Response `200`

Successful operation

- object
  - `business_profile_id` string
  - `company_reference_id` 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)