---
title: "List pending approvals"
method: GET
path: "/api/v2/pendingApprovals"
tags: ["Pending approval"]
---

# List pending approvals

`GET /api/v2/pendingApprovals`

## Query parameters

- `prevId` string
- `limit` integer
- `coin` Coin[]
- `enterpriseId` string
- `organizationId` string
- `requestType` 'enterpriseInviteRequest' | 'genericRequest' | 'policyRuleRequest' | 'transactionRequest' | 'transactionRequestFull' | 'updateApprovalsRequiredRequest' | 'updateEnterpriseRequest' | 'updateOrganizationRequest' | 'userChangeRequest'
- `state` PendingApprovalStatePending1[]
- `walletId` string
- `expandWalletLabels` boolean
- `expandAddressLabels` boolean

## Response `200`

OK

- PendingApprovals
  - `pendingApprovals` PendingApproval1[]
    - `id` string
    - `coin` string — A cryptocurrency or token ticker symbol.
    - `wallet` string
    - `enterprise` string
    - `organization` string
    - `creator` string
    - `createDate` string, date-time
    - `info` union
      - PendingApprovalTransactionRequest1
        - `transactionRequest` object
          - `buildParams` object
          - `coinSpecific` object
          - `comment` string
          - `fee` union
            - string
            - integer
          - `isUnsigned` boolean
          - `recipients` object[]
            - `address` string
            - `amount` union
              - …
            - `data` string
          - `requestedAmount` union
            - string
            - integer
          - `sourceWallet` string
          - `triggeredPolicy` string
          - `validTransaction` string
          - `validTransactionHash` string
        - `type` 'transactionRequest'
      - PendingApprovalTransactionRequestFull1
        - `transactionRequestFull` object
          - `txRequestId` string, required
          - `policyUniqueId` string
          - `verificationItems` string[]
          - `verificationRuleId` string
          - `videoApprovers` Id[]
          - `walletRebalanceEventId` string
          - `txRequest` union
            - object
              - …
            - object
              - …
        - `type` 'transactionRequestFull'
      - PendingApprovalUserChangeRequest
        - `type` 'userChangeRequest'
        - `userChangeRequest` object
          - `action` string
          - `permissions` string
          - `userChanged` string
      - PendingApprovalPolicyRuleRequest
        - `policyRuleRequest` object
          - `action` string
          - `update` object
            - `action` PolicyRuleActions — What happens when this rule is triggered
              - …
            - `coin` string — A cryptocurrency or token ticker symbol.
            - `condition` object
              - …
            - `id` string — the id of the rule that is being updated
            - `type` 'advancedWhitelist' | 'allTx' | 'bitcoinAddressWhitelist' | 'coinAddressWhitelist' | 'coinAddressBlacklist' | 'transactionLimit' | 'velocityLimit' | 'webhook' — What causes this rule to trigger
        - `type` 'policyRuleRequest'
      - PendingApprovalUpdateApprovalsRequiredRequest
        - `type` 'updateApprovalsRequiredRequest'
        - `updateApprovalsRequiredRequest` object
          - `requestedApprovalsRequired` number
      - PendingApprovalEnterpriseModificationResponse1
        - `policyRuleRequest` object
          - `action` string
          - `updateEnterpriseRequest` object
            - `type` 'updateEnterpriseRequest'
            - `action` 'add' | 'remove'
            - `permission` 'admin'
            - `userId` string
            - `email` string, email
        - `type` 'policyRuleRequest'
      - PendingApprovalEnterpriseInviteRequest
        - `type` 'enterpriseInviteRequest'
        - `enterpriseInviteRequest` object
          - `action` 'add'
          - `email` string — The email address of the user being invited
          - `userId` string
          - `isVideoIdUser` boolean
          - `enterpriseInfo` object
            - `id` string
            - `name` string — The name of the enterprise the user is being invited to
            - `requiredVerificationStep` string — The required verification step needed (if any) before the user can join the enterprise
            - `invitedBy` object
              - …
    - `state` union
      - 'pending' | 'awaitingSignature' | 'pendingFinalApproval' | 'pendingCustodianApproval' | 'pendingVideoApproval' | 'pendingIdVerification'
      - 'approved' | 'processing' | 'rejected'
    - `scope` 'enterprise' | 'wallet' — What kind of entity the Pending Approval is tied to
    - `userIds` Id[] — All the Users who should see this Pending Approval
    - `approvalsRequired` integer
    - `walletLabel` string
    - `resolvers` object[]
      - `user` string, required
      - `date` string, required
      - `resolutionType` 'approved' | 'awaitingSignature' | 'pending' | 'pendingBitGoAdminApproval' | 'pendingCryptographicApproval' | 'pendingCustodianApproval' | 'pendingFinalApproval' | 'pendingIdVerification' | 'pendingVideoApproval' | 'processing' | 'rejected', required
      - `signatures` string[], required
      - `videoApprover` string
      - `videoLink` string
      - `videoException` string
    - `addressLabels` PendingApprovalAddressLabel[]
      - `address` string, required
      - `label` string, nullable, required — A human-readable label for the address.
      - `walletLabel` string

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)