Skip to main content
GET
List beneficial owners

Authorizations

Authorization
string
header
required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Headers

X-Trace-Version
string

API version. Omit to use the default version.

Example:

"1"

Path Parameters

accountId
string<uuid>
required

UUID of the account.

Response

List of beneficial owners.

id
string<uuid>
required
read-only
Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

name
string
required
Example:

"João Silva"

taxId
object
required

Tax identifier returned for an owner or beneficial owner.

address
object
required
phone
string
required
Example:

"5511999999999"

email
string<email>
required
Example:

"joao.silva@example.com"

Example:

false

currentState
object
required

A point-in-time state of a beneficial owner.

ownershipPercentage
number<double> | null
Example:

50