List client grants

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

Retrieves a paginated list of client-specific grants for the specified user, including consent status and counts of issued refresh tokens, reference tokens, and authorization codes.

Pro

Access to grant and token information endpoints requires an active Pro plan 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 grants to return per page.

Formatint32
Range1 <= value <= 50
Default10

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 client grants were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

User Client Grants: Represents issued grants for a user-client relationship.

Errors

401Unauthorized

403Forbidden

curl -X GET "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/grants/clients?page=1&size=10" \  -H "X-API-KEY: <token>"
[  {    "client_id": "string",    "consented": true,    "refresh_tokens": 0,    "reference_tokens": 0,    "authorization_codes": 0  }]
© 2026 MonoCloud. All rights reserved.