---
title: "Get wallet share V1"
method: GET
path: "/api/v1/{coin}/walletshare/{shareId}"
tags: ["Wallet share"]
---

# Get wallet share V1

`GET /api/v1/{coin}/walletshare/{shareId}`

Returns a wallet share, requires unlock if the wallet share includes a keychain.

## Path parameters

- `coin` string, required — A cryptocurrency or token ticker symbol.
- `shareId` string, required

## Query parameters

- `skipUnlock` boolean

## Response `200`

OK

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

## Other responses

- `401` — Unauthorized

---

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