Beneficial Owner Summary Object (Customer Account)

The Beneficial Owner Summary object provides condensed information for a Beneficial Owner belonging to a Business Customer Account.

Attributes

parentId

string (UUID)

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

string (UUID)

ID of the Beneficial Owner.

firstName

string, min length: 1, max length: 40

Beneficial Owner’s first name.

middleName

string, min length: 1, max length: 40

Beneficial Owner’s middle name.

lastName

string, min length: 1, max length: 40

Beneficial Owner’s last name.

primaryPhoneNumber

object

Beneficial Owner’s primary phone number.

number

string

Phone number. Can be entered in any of the following formats:

[+][country code][phone number including area code] (example: +14151234)
[country code][phone number including area code] (example: 14151234)
[phone number including area code] (example: 4151234)

The phone number will be converted to E.164 format (example: +14151234).

type

string enum, values: WORK, HOME, MOBILE

Type of phone number.

provider

string, min length: 1, max length: 40

Phone provider.

extension

string, min length: 1, max length: 10

Phone extension.

verified

boolean

Whether the phone number has been verified through Identity Verification (IDV).

primaryEmail

object

Beneficial Owner’s primary email address.

value

string (email), max length: 320

Email address.

verified

boolean

Whether the email address has been verified through Identity Verification (IDV).

controller

boolean

Whether the Beneficial Owner exercises significant control over the business. For example, the Beneficial Owner may be the CEO, General Partner, or Treasurer.

verificationStatus

object

Current Identity Verification (IDV) status of the Beneficial Owner.

status

string enum, values: UNVERIFIED, PROCESSING, APPROVED, REVIEW, DECLINED, RESTRICTED

IDV status of the account. Possible values are:

UNVERIFIED The account has not yet been verified.
PROCESSING The account’s IDV application is currently being processed.
APPROVED The account has been verified successfully.
REVIEW A manual review of the IDV application is required.
DECLINED The account’s IDV application has been denied.
RESTRICTED The account has been verified with restrictions.

reason

string

Reason for the account’s IDV status.

updatedAt

string (date-time), format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the account’s IDV status was last updated.

updatedBy

object

Entity that last updated the account’s IDV status.

string (UUID)

ID of the entity. Will be blank if updatedBy.type is internal.

type

string enum, values: employee, internal, kor_employee, service-account

Type of entity. The following values are supported:

employee Team Member using the RocketKOR Portal.
internal Internal service call.
kor_employee Rocket Financial employee.
service-account Service Account using APIs.

Beneficial Owner Summary Object

				
					{
  "parentId": "string(UUID)",
  "id": "string(UUID)",
  "firstName": "string",
  "middleName": "string",
  "lastName": "string",
  "primaryPhoneNumber": {
    "number": "string",
    "type": "WORK | HOME | MOBILE",
    "provider": "string",
    "extension": "string",
    "verified": boolean
  },
  "primaryEmail": {
    "value": "string",
    "verified": boolean
  },
  "controller": boolean,
  "verificationStatus": {
    "status": "UNVERIFIED | PROCESSING | APPROVED | RESTRICTED | REVIEW | DECLINED",
    "reason": "string",
    "updatedAt": "string(date-time)",
    "updatedBy": {
      "id": "string(UUID)",
      "type": "employee | internal | kor_employee | service-account"
    }
  }
}