Retrieve a Beneficial Owner (Customer Account)

Retrieve a Beneficial Owner for a Business Customer Account.

Endpoint

GET /v1/customers/{customerId}/beneficiaries/{beneficiaryId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

customerId REQUIRED

string (UUID)

ID of the Business Customer Account to which the Beneficial Owner belongs.

beneficiaryId REQUIRED

string (UUID)

ID of the Beneficial Owner.

Request Body

None

Returns

Returns the Beneficial Owner object. This object contains the Beneficial Owner details, including a unique ID for the Beneficial Owner.

SAMPLE RESPONSE

				
					{
  "parentId": "69248436-39f5-4074-9823-76d2580c82a6",
  "id": "997dec9d-afcb-4843-a9e3-5333b6228229",
  "firstName": "Natalie",
  "middleName": "Sue",
  "lastName": "Smith",
  "sex": "FEMALE",
  "primaryPhoneNumber": {
    "number": "+17512312345",
    "type": "MOBILE",
    "provider": "XYZ Mobile",
    "verified": false
  },
  "primaryEmail": {
    "value": "nsmith@example.com",
    "verified": false
  },
  "dateOfBirth": "1981-05-11",
  "placeOfBirth": {
    "city": "New York",
    "countryCode": "USA"
  },
  "socialId": "123-45-6789",
  "socialIdCountryCode": "USA",
  "citizenshipCountryCode": "USA"
  "title": "CEO",
  "ownershipPercentage": 50,
  "controller": true,
  "addresses": [
    {
      "type": "MAILING",
      "streetLine1": "400 Richmond St",
      "streetLine2": "Suite 500",
      "cityName": "New York",
      "stateCode": "NY",
      "countryCode": "USA",
      "zipCode": "10001",
      "primary": true,
      "verified": false
    }
  ],
  "verificationStatus": {
    "status": "UNVERIFIED",
    "reason": "Processing",
    "updatedAt": "2024-08-12T01:09:27.246Z",
    "updatedBy": {
      "id": "cb51cced-fb9a-43cd-abc8-c6842c871262",
      "type": "employee"
    }
  },
  "verificationStatusHistory": [
    {
      "status": "UNVERIFIED",
      "reason": "Processing",
      "updatedAt": "2024-08-12T01:09:27.246Z",
      "updatedBy": {
        "id": "cb51cced-fb9a-43cd-abc8-c6842c871262",
        "type": "employee"
      }
    },
    {...},
    {...}
  ],
  "createdBy": {
    "id": "b6333b53-3222-4227-a71e-718b25ca3ea4",
    "type": "service-account"
  },
  "createdAt": "2024-05-20T00:42:50.311Z",
  "updatedBy": {
    "id": "b6333b53-3222-4227-a71e-718b25ca3ea4",
    "type": "service-account"
  },
  "updatedAt": "2024-06-12T00:42:50.311Z"
}