List related persons for a business customer

GET 
/v1/customers/business/:businessUserId/related-persons

Returns all person relations for a business customer, including their role and ownership percentage.

Pre-approval: Returns relations from the onboarding data. Post-approval: Returns relations from materialized beneficial owner records (includes KYC status).

Request

Path Parameters

businessUserId stringrequired

The ID of the business customer

Responses

200

Related persons retrieved successfully

application/json

Schema

Schema

message string

data

object[]

Array [

userId string

User ID of the related person

role string

Possible values: [REPRESENTATIVE, SHAREHOLDER]

Role of the person in the business

ownershipPercentage stringnullable

Ownership percentage as string (e.g. "51", "30.5"). Present for SHAREHOLDER role.

kycComplete boolean

Whether the related person has completed individual KYC. Only present after KYB approval.

]

traceId string

Example (from schema)

{
  "message": "string",
  "data": [
    {
      "userId": "string",
      "role": "REPRESENTATIVE",
      "ownershipPercentage": "string",
      "kycComplete": true
    }
  ],
  "traceId": "string"
}

Loading...