---
title: "List grantable API key scopes"
method: GET
path: "/keys/scopes"
tags: ["Key Management"]
---

# List grantable API key scopes

`GET /keys/scopes`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/keys/scopes`
- Auth: HTTP bearer

Every scope the API accepts on key creation, with its label, description and status: active (enforced), alias (an alternate name for an active scope) or reserved (accepted, no effect today).

## Response `200`

Scope catalog

- object
  - `scopes` object[]
    - `id` string
    - `label` string
    - `description` string
    - `status` 'active' | 'alias' | 'reserved'

## Other responses

- `401`: Authentication required

---

[API](https://skmtc.dev/arkova/apis/arkova-verification-api.md) · [All operations](https://skmtc.dev/arkova/apis/arkova-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arkova/apis/arkova-verification-api/revisions/a14858d1efd4?raw)