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

# List scopes

`GET /v1/scopes`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/scopes`
- Auth: HTTP bearer

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: Resource type discriminator.
    - `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' | 'counterparties:read' | 'counterparties:write' | 'webhook_subscriptions:read' | 'webhook_subscriptions:write' | 'events:read' | 'webhook_deliveries:read' | 'webhook_deliveries:write' | 'transactions:read' | 'simulations:write' | 'payout_tracking_events: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
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-21** `79d607871de9`: 3 warning
  - added the new `counterparties:read` enum value to the `data/items/id` response property for the response status `200`
  - added the new `counterparties:write` enum value to the `data/items/id` response property for the response status `200`
  - added the new `simulations:write` enum value to the `data/items/id` response property for the response status `200`
- **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`

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

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)