List reference tokens

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

Retrieves a paginated list of reference tokens issued for the specified user. Reference tokens are opaque access tokens that require introspection for validation. 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 reference tokens were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

Reference Token: Represents an opaque access token issued to a client.

Errors

401Unauthorized

403Forbidden

curl -X GET "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/grants/reference_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.