---
title: "Get permission context"
method: GET
path: "/v4/account/api-keys/permission-context"
---

# Get permission context

`GET /v4/account/api-keys/permission-context`

Returns the permission structure and allowed permissions for your account. Use this to build permission selection UIs or validate permissions before creating a key. Permission: `account:apikeys:read`.

## Response `200`

Permission context with structure and allowed permissions

- object
  - `structure` object — Hierarchical permission structure filtered to only the permissions your account can assign.
    - `account` object
      - `sub_types` object[]
        - `id` string — Unique identifier for this sub-type.
        - `name` string — Human-readable label for this sub-type.
        - `description` string — Description of what this sub-type covers.
        - `permissions` object[]
          - `id` string — Permission string, e.g. datacenter_shared:read.
          - `name` string — Human-readable permission label.
          - `description` string — What this permission grants.
          - `enabled` boolean — Whether this permission is enabled by default for new accounts.
    - `product` object
      - `sub_types` object[]
        - `id` string — Unique identifier for this sub-type.
        - `name` string — Human-readable label for this sub-type.
        - `description` string — Description of what this sub-type covers.
        - `permissions` object[]
          - `id` string — Permission string, e.g. serp_api:read.
          - `name` string — Human-readable permission label.
          - `description` string — What this permission grants.
          - `enabled` boolean — Whether this permission is enabled by default for new accounts.
  - `allowed_permissions` string[] — Flat list of permission strings you can assign

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/proxyscrape/apis/proxyscrape-account-api.md) · [All operations](https://skmtc.net/proxyscrape/apis/proxyscrape-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/proxyscrape/proxyscrape-account-api/revisions/4e10267785e1/schema)