API reference/Endpoints
User Sessions
GET /sessions
Lists the tenant's session history (login/logout/MFA).
Authentication: this route does not use an API Key: it requires an authenticated browser session with the ADMIN, SUPER_ADMIN or AUDITOR role.
Query params:
| Param | Type | Description | |||
|---|---|---|---|---|---|
userId |
string | Filter by user | |||
action |
string | LOGIN |
LOGOUT |
MFA_VERIFY |
SESSION_EXPIRED |
success |
string | "true" |
"false" |
||
from |
ISO 8601 | Start date | |||
to |
ISO 8601 | End date | |||
limit |
int | Maximum number of results (default 100, max 500) | |||
cursor |
string | Cursor pagination (id of the last record) |
Response:
{
"data": [
{
"id": "sl_abc123",
"action": "LOGIN",
"ipAddress": "203.0.113.10",
"userAgent": "Mozilla/5.0 (Windows NT 10.0) Chrome/126",
"deviceName": "Windows · Chrome",
"success": true,
"failureReason": null,
"createdAt": "2026-06-30T08:15:00Z",
"user": { "id": "usr_xyz", "name": "João Silva", "email": "joao@empresa.pt" }
}
],
"meta": { "total": 1, "hasMore": false, "nextCursor": null }
}
Note:
meta.totalreflects the number of records on this page (the size of the returned page), not the absolute total of the tenant's sessions. To paginate, usehasMore+nextCursor.
Coming soonThis page will be available soon.