latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Pending approval

List pending approvals

Returns pending approvals for the authenticated user, filterable by wallet, enterprise, coin, state, and request type. By default includes approvals in awaitingSignature, pending, or pendingFinalApproval states.

get/api/v2/pendingapprovals

Query parameters

walletIdstring
Example:59cd72485007a239fb00282ed480da1f

Filter by wallet ID

string
OR
string[]

Filter by enterprise (single ID or up to 20 IDs)

organizationIdstring

Filter by organization

scope'enterprise' | 'wallet' | 'organization' | 'global' | 'safe'

Filter by scope

string
OR
string[]

Filter by coin

string
OR
string[]

Filter by coins

Filter by state

allTokensboolean

When true, include all tokens for each coin filter

expandWalletLabelsboolean

When true, add walletLabel to each returned pending approval

prevIdstring

Return the next batch of results from the previous nextBatchPrevId

limitstring number

Maximum number of results to return. If truncated, use nextBatchPrevId for the next batch.

offsetstring number

Number of documents to skip for offset-based pagination

expandAddressLabelsboolean

When true, adds addressLabels to each returned pending approval

'userChangeRequest' | 'transactionRequest' | 'transactionRequestFull' | 'policyRuleRequest' | 'updateApprovalsRequiredRequest' | 'updateEnterpriseRequest' | 'updateOrganizationRequest' | 'genericRequest' | 'enterpriseInviteRequest' | 'updateWalletSettingRequest' | 'updateWalletTagsRequest'
OR
string[]

Filter by request type

requestResourceType'countersigningSettlement' | 'policyRule' | 'signingSettlement' | 'ethUnstake' | 'userEmail' | 'organizationAdmin' | 'organizationAdminInvite' | 'crossChainRecovery'

Filter by generic request resource type

includeEvmKeyringWalletsboolean

When true, include pending approvals from all wallets in the same EVM keyring

Response

OK

nextBatchPrevIdstring
countnumber