---
title: "Link Existing User as Related Person V2"
method: POST
path: "/verify/link_existing_user_as_related_person_v2"
tags: ["KYB > Related Entities V2 (Recommended)"]
---

# Link Existing User as Related Person V2

`POST /verify/link_existing_user_as_related_person_v2`

Link an existing user profile as a related person to a business profile

## Request body

- LinkExistingUserAsRelatedPersonV2RequestSchema
  - `business_profile_id` string, required — The business profile ID
  - `person_reference_id` string, required — The existing user profile ID to link
  - `ownership_percent` number, nullable — Percentage of ownership in the business
  - `shares_allocated` integer, nullable — Number of shares allocated to this person
  - `roles` PersonRoleDetails[] — List of roles held by this person 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

## Response `200`

Successful operation

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