---
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`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/verify/related_company_v2`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/verify/related_company_v2/put.ts> (a function with typed inputs; its response is checked against the schema)

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' | 'TAX_REGISTRATION_CERTIFICATE' | 'INTENDED_USAGE_DOCUMENT' | '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
    - `normalised_name` 'ULTIMATE_BENEFICIAL_OWNER' | 'CONTROLLING_PERSON' | 'DIRECTOR' | 'LEGAL_REPRESENTATIVE' | 'SHAREHOLDER' | 'EMPLOYEE' | 'UNKNOWN', 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

## Changes

- **2026-11-03** `74fc7a5199fb`: 9 info
  - added the new optional request property `roles/items/normalised_name` (media type: application/json)
  - added the new optional request property `roles/items/normalised_name` (media type: application/xml)
  - added the new optional request property `roles/items/normalised_name` (media type: application/x-www-form-urlencoded)
  - added the new `INTENDED_USAGE_DOCUMENT` enum value to the request property `business_profile/additional_information/items/additional_info_type` (media type: application/json)
  - …5 more

[Operation history](https://skmtc.dev/aiprise/apis/aiprise-apis/changes/verify/related_company_v2/put.md)

---

[API](https://skmtc.dev/aiprise/apis/aiprise-apis.md) - [All operations](https://skmtc.dev/aiprise/apis/aiprise-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/aiprise/apis/aiprise-apis/revisions/74fc7a5199fb?raw)