---
title: "List wallet shares"
method: GET
path: "/api/v2/walletshares"
tags: ["Wallet share"]
---

# List wallet shares

`GET /api/v2/walletshares`

List shares of all wallets with other BitGo users. Returns only wallets on which the current user has spend permission.

## Response `200`

OK

- ListWalletSharesResponse
  - `incoming` WalletShare1[]
    - `id` string, required
    - `coin` string, required — A cryptocurrency or token ticker symbol.
    - `wallet` string, required
    - `walletLabel` string, required
    - `fromUser` string, required
    - `toUser` string, required — A cryptocurrency or token ticker symbol.
    - `permission` 'admin' | 'spend' | 'trade' | 'view' — Comma-separated list of privileges for a wallet. Includes: - `admin` - Can manage wallet policies and users and approve or reject pending approvals. - `freeze` - Can freeze a wallet, disabling all withdrawals. - `spend` - Can initiate withdrawals and generate new receive addresses. - `trade` - Can initiate trades from a Go Account (`trading` wallet type). - `view` - Can view balances and transactions. Permissions don't overlap. Required parameter if 'reshare' is false.
    - `message` string, required — User readable message to display to the share recipient
    - `state` 'pendingapproval' | 'active' | 'accepted' | 'canceled' | 'rejected', required
    - `enterprise` string, required
    - `pendingApprovalId` string
    - `keychain` object — Only set if this wallet share has an associated keychain
      - `pub` string — Sharing user's root public key
      - `encryptedPrv` string — Sharing user's private key encrypted under their wallet passphrase
      - `fromPubKey` string — Sharing user's derived public key which will be used to calculate the wallet sharing secret.
      - `toPubKey` string — Shared-to user's derived public key which will be used to calculate the wallet sharing secret.
      - `path` string — BIP32 HD path of the derived public keys (fromPubKey and toPubKey)
  - `outgoing` WalletShare1[]
    - `id` string, required
    - `coin` string, required — A cryptocurrency or token ticker symbol.
    - `wallet` string, required
    - `walletLabel` string, required
    - `fromUser` string, required
    - `toUser` string, required — A cryptocurrency or token ticker symbol.
    - `permission` 'admin' | 'spend' | 'trade' | 'view' — Comma-separated list of privileges for a wallet. Includes: - `admin` - Can manage wallet policies and users and approve or reject pending approvals. - `freeze` - Can freeze a wallet, disabling all withdrawals. - `spend` - Can initiate withdrawals and generate new receive addresses. - `trade` - Can initiate trades from a Go Account (`trading` wallet type). - `view` - Can view balances and transactions. Permissions don't overlap. Required parameter if 'reshare' is false.
    - `message` string, required — User readable message to display to the share recipient
    - `state` 'pendingapproval' | 'active' | 'accepted' | 'canceled' | 'rejected', required
    - `enterprise` string, required
    - `pendingApprovalId` string
    - `keychain` object — Only set if this wallet share has an associated keychain
      - `pub` string — Sharing user's root public key
      - `encryptedPrv` string — Sharing user's private key encrypted under their wallet passphrase
      - `fromPubKey` string — Sharing user's derived public key which will be used to calculate the wallet sharing secret.
      - `toPubKey` string — Shared-to user's derived public key which will be used to calculate the wallet sharing secret.
      - `path` string — BIP32 HD path of the derived public keys (fromPubKey and toPubKey)

---

[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)