Skip to content
Authrim

List admin sessions.

GET
/api/admin/sessions
Code sample: Shell / cURL 
curl --request GET \
  --url https://auth.example.com/api/admin/sessions \
  --header 'Authorization: Bearer <token>'

List persisted user sessions for the current tenant, optionally filtered by user and active or expired status. User contact information is read from each account’s owning data store, including suspended and locked accounts. If the owner required to audit disclosed personal session fields cannot be verified, the request returns an error without disclosing those fields. Page must be a positive safe integer and limit an integer from 1 to 500; malformed values or an unsafe pagination offset return 400 invalid_request. Contacts are resolved from the current verified tenant inventory only. Accounts outside that inventory, or without verified personal data ownership, have null contact fields; unrelated default stores are never used. A database read failure fails the entire request rather than returning a partial successful page.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
X-Tenant-Id
string

Tenant selector for multi-tenant admin requests.

Query Parameters

Section titled “Query Parameters ”
page
integer
>= 1
limit
integer
>= 1 <= 500

Responses

Section titled “ Responses ”

200

Section titled “200 ”

User session list response.

Media type application/json
object
sessions
required
Array<object>
object
id
required
string
user_id
required
string
user_email
required
string | null format: email
user_name
required
string | null
created_at
required
string format: date-time
last_accessed_at
required
string format: date-time
expires_at
required
string format: date-time
ip_address
required
string | null
user_agent
required
string | null
is_active
required
boolean
key
additional properties
pagination
required
object
page
required
integer
>= 1
limit
required
integer
>= 1
total
required
integer
totalPages
required
integer
hasNext
required
boolean
hasPrev
required
boolean
key
additional properties
Example 
{
  "sessions": [
    {
      "id": "sess_123",
      "user_id": "user_123",
      "user_email": "user@example.com",
      "user_name": "Example User",
      "created_at": "2026-06-19T00:00:00.000Z",
      "last_accessed_at": "2026-06-19T00:10:00.000Z",
      "expires_at": "2026-06-20T00:00:00.000Z",
      "ip_address": "203.0.113.10",
      "user_agent": "Mozilla/5.0",
      "is_active": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Section titled “500 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}