---
title: "Add Related Person V2"
method: POST
path: "/verify/related_person_v2"
tags: ["KYB > Related Entities V2 (Recommended)"]
---

# Add Related Person V2

`POST /verify/related_person_v2`

Add a related person to a business profile using the V2 format

## Request body

- AddRelatedPersonV2RequestSchema
  - `business_profile_id` string, required — The business profile ID to which the related person will be added
  - `user_profile` object, required — The user profile information for the related person
    - `user_profile_id` string
    - `first_name` string, nullable
    - `middle_name` string, nullable
    - `last_name` string, nullable
    - `second_last_name` string, nullable
    - `full_name` string, nullable
    - `address` Address
      - `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
    - `date_of_birth` string — The person's date of birth in YYYY-MM-DD format
    - `email_address` string — The person's email address
    - `phone_number` string — The person's phone number. Prefer phone number in E.164 format
    - `phone_number_parts` object, nullable — The Person's phone number details like country code, phone code, and number (Used internally for client SDK).
      - `countryCode` string, nullable
      - `phoneCode` string, nullable
      - `number` string, nullable
    - `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.
    - `verification_session_ids` string[] — List of verification sessions run against this User
    - `user_profile_result` 'APPROVED' | 'DECLINED' | 'REVIEW' | 'UNKNOWN' | 'DEACTIVATED' — The result status for business/user profile APIs. Includes DEACTIVATED for deactivating profiles.
    - `questions_response` object — Questions responded by the business
    - `events_callback_url` string
    - `source` string[] — The source(s) of the user profile data
  - `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)