List user consents

View as Markdown
GET
/users/{user_id}/grants/consents

Retrieves a paginated list of consents granted by the specified user. Each consent includes the application's approved scopes and associated metadata. Optional query parameters allow searching, filtering, and sorting the results.

Secure+

Access to grant and token management endpoints requires an active Secure+ subscription.

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>

Path Parameters

user_id*string

The unique identifier of the user.

Query Parameters

page?integer

The page number to retrieve.

Formatint32
Range1 <= value
Default1
size?integer

The number of consent grants to return per page.

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

Filters results to consent grants issued to the specified client.

sort?string

Sort expression in the format field:direction, where direction is 1 for ascending or -1 for descending. Supported fields include - 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 user's consent grants were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

User Consent: Represents a consent grant issued by a user to a specific client.

Errors

401Unauthorized

403Forbidden

curl -X GET "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/grants/consents?page=1&size=10&client_id=eCOGRJYpnNwwAAuCeReEW&sort=creation_time%3A1" \  -H "X-API-KEY: <token>"
[  {    "id": "string",    "client_id": "string",    "creation_time": 0,    "scopes": [      {        "scope": "string",        "granted_on": 0,        "expiration": null      }    ]  }]
© 2026 MonoCloud. All rights reserved.