List scopes

View as Markdown
GET
/resources/scopes

Retrieves a paginated list of identity scopes. Optional query parameters allow searching, filtering, and sorting the results.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Query Parameters

page?integer

The page number to retrieve.

Formatint32
Range1 <= value
Default1
size?integer

The number of resources to return per page.

Formatint32
Range1 <= value <= 50
Default10
filter?string

Optional Lucene-style filter expression used to search by attributes.

sort?string

Sort expression in the format field:direction, where direction is 1 for ascending or -1 for descending. Supported fields include - name, display_name, and creation_time

Response Headers

200

x-Pagination?object

Returns the x-Pagination header

page_size*integer

Number of items returned per page.

Formatint32
current_page*integer

The current page number.

Formatint32
total_count*integer

Total number of items available.

Formatint32
has_previous*boolean

Indicates whether a previous page exists.

has_next*boolean

Indicates whether a next page exists.

Response Body

200

application/json

The scopes were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

Scope Response: Represents a permission that can be requested by clients and evaluated during authorization.

Errors

401Unauthorized
403Forbidden
curl -X GET "https://your-domain.us.monocloud.com/api/resources/scopes?page=1&size=10&filter=api&sort=creation_time%3A1" \  -H "X-API-KEY: <token>"
[  {    "id": "string",    "display_name": null,    "description": null,    "show_in_discovery_document": true,    "creation_time": 0,    "last_updated": 0,    "name": "string",    "required": true,    "emphasize": true,    "is_default": true,    "user_claims": [      {        "claim": "string",        "include_in_identity_token": true,        "include_in_user_info": true      }    ]  }]
© 2026 MonoCloud. All rights reserved.