List user sessions
Retrieves a paginated list of all active sessions for the specified user. Optional query parameters allow searching, filtering, and sorting the results.
Access to user session management endpoints requires an active Pro plan subscription.
API-KeyX-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>
The unique identifier of the user.
The page number to retrieve.
int321 <= value1The number of user sessions to return per page.
int321 <= value <= 5010Filters results to user sessions associated with the specified client.
Sort expression in the format field:direction, where direction is 1 for ascending or -1 for descending.
Supported fields include - session_id, initiated_at, expires_at, last_updated.
Response Headers
200
Returns the x-Pagination header
Number of items returned per page.
int32The current page number.
int32Total number of items available.
int32Indicates whether a previous page exists.
Indicates whether a next page exists.
Response Body
application/json
The user's sessions were retrieved successfully
TypeScript Definitions
Use the response body type in TypeScript.
Returns an array. Each item has the fields below.
User Session: Represents an authentication session for a user.
Errors
curl -X GET "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/sessions?page=1&size=10&client_id=eCOGRJYpnNwwAAuCeReEW&sort=initiated_at%3A1" \ -H "X-API-KEY: <token>"[ { "session_id": "string", "client_ids": [ "string" ], "initiated_at": 0, "expires_at": 0, "last_updated": 0, "last_metadata": { "city": null, "country": null, "region": null, "latitude": null, "longitude": null, "ip_address": null, "user_agent": null } }]Reset IP lockout POST
Removes the lockout applied to the specified IP due to excessive failed authentication attempts, allowing sign-in attempts from that IP again. Providing the value all resets lockouts for every IP associated with the user.
Retrieve a user session GET
Retrieves detailed information about a specific session for the specified user.