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

# Update Related Person V2

`PUT /verify/related_person_v2`

## Request

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

Update a related person's information using the V2 format

## Request body

- UpdateRelatedPersonV2RequestSchema
  - `business_profile_id` string, required: The business profile ID
  - `person_reference_id` string, required: The person reference ID to update
  - `user_profile` UserProfileInputOnly, required
    - `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
  - `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
    - `normalised_name` 'ULTIMATE_BENEFICIAL_OWNER' | 'CONTROLLING_PERSON' | 'DIRECTOR' | 'LEGAL_REPRESENTATIVE' | 'SHAREHOLDER' | 'EMPLOYEE' | 'UNKNOWN', 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

## 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/related_person_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)