Get beneficial owners.
Retrieves beneficial owners (business stakeholders) for bank account applications. BANK callers see all stakeholders across their partner VSPs. PLATFORM callers see stakeholders for their visible organizations. When available, the last 4 digits of the SSN are returned via the ssnLast4 field.
Token types: APP, USER | Required scopes: beneficial_owner:read:org
Authorizations
Application (M2M) OAuth2 access token (client credentials).
Headers
ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.
Query Parameters
Number of items to return (default 25, max 100).
Opaque pagination token from a previous response.
Response
Beneficial owners retrieved successfully.
A paginated response containing a page of results and navigation tokens.
The items in the current page.
A token that can be sent in the pagination_token query parameter to get the next page of results, or null if there is no next page.
A token that can be sent in the pagination_token query parameter to get the previous page of results, or null if there is no previous page.