---
title: "List scopes"
method: GET
path: "/api/policy/v1/enterprises/{enterpriseId}/scopes"
tags: ["Policy Builder"]
---

# List scopes

`GET /api/policy/v1/enterprises/{enterpriseId}/scopes`

Lists all scopes for a given policy rule.

## Path parameters

- `enterpriseId` string, required

## Response `200`

All available scopes for your enterprise.

- Scopes — Wrapper object for a list of scopes. Not paginated.
  - `scopes` AllWalletsScope[] — A list of scopes available on your Enterprise.
    - `id` string, required — Unique id of the scope. A UUID.
    - `name` 'wallet.segregated', required — Name of the scope.
    - `label` string, required — A label for the scope which can be shown to an end user.
    - `description` string, required — A description for the scope which can be shown to an end user.
    - `conditions` union[], required — A list of Filtering Conditions the scope supports. For example the Wallet Type Filtering condition.
      - union
        - WalletTypeCondition — Wallet-type condition for the all-wallets scope.
          - `name` 'wallet.type', required — The name of the condition.
          - `label` string, required — A label for the condition which can be shown to an end user.
          - `description` string, required — A description for the condition which can be shown to an end user.
          - `status` 'ACTIVE' | 'INACTIVE', required — Status of the condition. Indicates if the condition is usable `ACTIVE` or not `INACTIVE`. * `ACTIVE` - The condition is available for use. * `INACTIVE` - The condition is NOT available for use.
          - `parameters` WalletTypeParameter[], required — A list of Parameters to control how the condition behaves.
            - `name` 'walletType', required — The name of the condition parameter.
            - `label` string, required — A description for the condition parameter which can be shown to an end user.
            - `description` string, required — A description for the condition parameter which can be shown to an end user.
            - `type` 'ENUMERATED', required — This Conditions parameter has a set of defined values.
            - `required` 'ALWAYS', required — This Conditions parameter must always be provided.
            - `allowMultiple` boolean, required — true, if multiple values can be provided, i.e. as a list of values. When false only one value can be provided, i.e. a list with more than one element will be rejected.
            - `values` union[], required — A list of valid values, only values from this list will be accepted.
              - …
        - WalletIdsCondition — Wallet ID condition for the all-wallets scope.
          - `name` 'wallet.ids', required — The name of the condition.
          - `label` string, required — A label for the condition which can be shown to an end user.
          - `description` string, required — A description for the condition which can be shown to an end user.
          - `status` 'ACTIVE' | 'INACTIVE', required — Status of the condition. Indicates if the condition is usable `ACTIVE` or not `INACTIVE`. * `ACTIVE` - The condition is available for use. * `INACTIVE` - The condition is NOT available for use.
          - `parameters` WalletIdParameter[], required — A list of Parameters to control how the condition behaves.
            - `name` 'walletId', required — The name of the condition parameter.
            - `label` string, required — A description for the condition parameter which can be shown to an end user.
            - `description` string, required — A description for the condition parameter which can be shown to an end user.
            - `type` 'BITGO_WALLET_ID', required — The type of acceptable values for this condition parameter.
            - `required` 'ALWAYS', required — This Conditions parameter must always be provided.
            - `allowMultiple` boolean, required — true, if multiple values can be provided, i.e. as a list of values. When false only one value can be provided, i.e. a list with more than one element will be rejected.
        - WalletAllCondition — Wallet-all condition for the all-wallets scope.
          - `name` 'wallet.all', required — The name of the condition.
          - `label` string, required — A label for the condition which can be shown to an end user.
          - `description` string, required — A description for the condition which can be shown to an end user.
          - `status` 'ACTIVE' | 'INACTIVE', required — Status of the condition. Indicates if the condition is usable `ACTIVE` or not `INACTIVE`. * `ACTIVE` - The condition is available for use. * `INACTIVE` - The condition is NOT available for use.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found
- `500` — Server Error - Transient error please try again

---

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