---
title: "Get the caller's Link permissions"
method: GET
path: "/api/link/v1/enterprises/{enterpriseId}/permissions"
tags: ["Link Permissions"]
---

# Get the caller's Link permissions

`GET /api/link/v1/enterprises/{enterpriseId}/permissions`

Returns the calling user's effective Link permissions for the enterprise:
the enterprise-wide `bitgo.link.admin` flag plus effective account-level
admin / transfer / view scopes. Reveals only the caller's own permissions.

## Path parameters

- `enterpriseId` string, required

## Headers

- `user-id` string, required

## Response `200`

OK

- V1GetLinkPermissionsResponse — The calling user's Link permissions for one enterprise. Each account scope is the permission as resolved by UMS (UMS already includes implied grants — e.g. a `link.account.admin`/`transfer` grant carries the implied `link.account.view`), so consumers only need membership checks. `bitgoLinkAdmin` is a distinct enterprise-wide capability, reported separately and not folded into the scopes.
  - `bitgoLinkAdmin` boolean, required — Enterprise-wide `bitgo.link.admin` grant. Drives non-account-scoped actions (e.g. "+ Link Account").
  - `admin` union — `link.account.admin` (manage) scope, as resolved by UMS. Omitted when the user has no admin grant.
    - object
      - `scope` 'ALL', required
    - object
      - `accounts` string[], required
      - `scope` 'LIMITED', required
  - `transfer` union — `link.account.transfer` scope, as resolved by UMS. Omitted when the user has no transfer grant.
    - object
      - `scope` 'ALL', required
    - object
      - `accounts` string[], required
      - `scope` 'LIMITED', required
  - `view` union — `link.account.view` scope, as resolved by UMS (includes accounts implied by admin/transfer grants). Omitted when none.
    - object
      - `scope` 'ALL', required
    - object
      - `accounts` string[], required
      - `scope` 'LIMITED', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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