---
title: "Link Existing Business as Related Company V2"
method: POST
path: "/verify/link_existing_business_as_related_company_v2"
tags: ["KYB > Related Entities V2 (Recommended)"]
---

# Link Existing Business as Related Company V2

`POST /verify/link_existing_business_as_related_company_v2`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/verify/link_existing_business_as_related_company_v2`
- Auth: API key in header `X-API-KEY`

Link an existing business profile as a related company to another business profile

## Request body

- LinkExistingBusinessAsRelatedCompanyV2RequestSchema
  - `business_profile_id` string, required: The business profile ID
  - `company_reference_id` string, required: The existing business profile ID to link
  - `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, required

## Response `200`

Successful operation

- object
  - `business_profile_id` string
  - `company_reference_id` string

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `74fc7a5199fb`: 3 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)

[Operation history](https://skmtc.dev/aiprise/apis/aiprise-apis/changes/verify/link_existing_business_as_related_company_v2/post.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)