List refresh tokens

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

Retrieves a paginated list of refresh tokens issued for the specified user. 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 grants to return per page.

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

Filters results to grants issued to the specified client.

session_id?string

Filters results to grants issued within the specified session.

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 refresh tokens were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

Refresh Token: Represents a long-lived refresh token issued to a client.

Errors

401Unauthorized

403Forbidden

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