---
title: "List scopes"
method: GET
path: "/v1/scopes"
tags: ["Scopes"]
---

# List scopes

`GET /v1/scopes`

Returns the catalogue of scopes available to API keys. The list is filtered by the `Api-Version` request header and defaults to the latest version when the header is omitted. Public: no authentication required.

## Response `200`

Scope catalogue

- ListScopesResponseDto
  - `data` object[], required
    - `type` 'scope', required
    - `id` 'payouts:read' | 'payouts:write' | 'deposits:read' | 'returns:read' | 'returns:write' | 'conversions:read' | 'conversions:write' | 'quotes:read' | 'accounts:read' | 'accounts:write' | 'account_programs:read' | 'account_holders:read' | 'account_holders:write' | 'webhook_subscriptions:read' | 'webhook_subscriptions:write' | 'events:read' | 'webhook_deliveries:read' | 'webhook_deliveries:write' | 'transactions:read', required — Scope identifier in `resource:action` format.
    - `description` string, required — Human-readable description of the scope.
    - `resource` string, required — Resource the scope applies to.
    - `action` 'read' | 'write', required — Action category.
    - `available_from` string, required — First API version that exposes this scope.
    - `deprecated_in` string, nullable, required — API version in which this scope was deprecated; null if not deprecated.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Changes

- **2026-07-24** `e2a23b7a5f9f` — 2 warning
  - added the new `account_holders:read` enum value to the `data/items/id` response property for the response status `200`
  - added the new `account_holders:write` enum value to the `data/items/id` response property for the response status `200`
- **2026-07-20** `34dee3db0e93` — 1 warning
  - added the new `transactions:read` enum value to the `data/items/id` response property for the response status `200`
- **2026-07-10** `2df25917fff2` — 1 info
  - removed the `account_openings:write` enum value from the `data/items/id` response property for the response status `200`
- **2026-07-08** `d879cc9cc2e7` — 1 warning
  - added the new `account_openings:write` enum value to the `data/items/id` response property for the response status `200`
- **2026-05-06** `6cb3ad3dbfc1` — 1 breaking, 3 info
  - removed the required property `type` from the response with the `200` status
  - added the required property `data/items/type` to the response with the `200` status
  - added the required property `has_more` to the response with the `200` status
  - added the required property `next_cursor` to the response with the `200` status

[Full history](https://skmtc.dev/augustus/apis/augustus-banking-api/changes/v1/scopes/get.md)

---

[API](https://skmtc.dev/augustus/apis/augustus-banking-api.md) · [All operations](https://skmtc.dev/augustus/apis/augustus-banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/augustus-banking-api/revisions/37109d1ed976/schema)