---
title: "Get all scopes."
method: GET
path: "/scopes"
tags: ["Subscription Validation"]
---

# Get all scopes.

`GET /scopes`

This will provide access to the Scopes created in database.

## Query parameters

- `scopeKey` string

## Headers

- `xWSO2Tenant` string, required

## Response `200`

An array of Scopes in Database.

- ScopesList
  - `count` integer — Number of Scopes returned.
  - `list` Scope[]
    - `name` string
    - `displayName` string
    - `description` string
    - `roles` string[]
  - `pagination` Pagination
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `next` string — Link to the next subset of resources qualified. Empty if no more resources are to be returned.
    - `previous` string — Link to the previous subset of resources qualified. Empty if current subset is the first subset returned.

## Other responses

- `default` — Unexpected error

## Changes

- **2025-04-03** `eb07388f2892` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `default`
- **2024-01-29** `f2e9e07fd354` — 2 breaking
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `default`

[Change history](https://skmtc.dev/wso2/apis/internal-utility-api/changes/scopes/get.md)

---

[API](https://skmtc.dev/wso2/apis/internal-utility-api.md) · [All operations](https://skmtc.dev/wso2/apis/internal-utility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wso2/internal-utility-api/revisions/0be9aa8493bc/schema)