Ctrl+K

List bulk pending wallet shares and wallet share requests for UMS admin console

post/api/v2/bulkpendingwalletshares/list

Returns DISTINCT user IDs categorized by their required actions:

  • usersWaitingForShare: Users in walletShareRequests waiting to receive keys from others
  • usersToAcceptShare: Users with active wallet shares who need to accept the share

Supports three valid combinations:

  1. { userIds, organizationId } - Query by organization and users
  2. { walletId } - Query by wallet only
  3. { userIds, walletId } - Query by users and specific wallet

Request Body

organizationId string
Organization ID (optional, required with userIds when walletId not provided)
Min length: >= 1 characters
userIds array[string]
Array of user IDs to check for pending wallet shares (optional, max 500) Required unless only walletId is provided
walletId string
Wallet ID to filter by (optional)
Min length: >= 1 characters

200 Response

usersWaitingForShare array[string] required
Users waiting to receive shared keys from others These are users in walletShareRequests who have been granted permissions but haven't received the keys yet
usersToAcceptShare array[string] required
Users who need to ACCEPT shared keys from others These are users who have active wallet shares (state='active') They are waiting to receive and accept keys

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

401 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id