Users

List users

Returns a cursor-paginated list of users in your organization.

GET /v1/users

string

Opaque pagination cursor. Pass next_cursor from a previous response. Omit for the first page.

integer

default:"25"

Maximum items per page (1–100).

string

Filter by account status: active, inactive, or suspended.

string

Filter by department name (e.g., engineering).

Request

curl "https://api.toktra.io/v1/users?status=active&department=engineering" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

{
  "items": [
    {
      "id": "u1a2b3c4-0000-0000-0000-000000000001",
      "org_id": "a1b2c3d4-0000-0000-0000-000000000000",
      "email": "jane.smith@acme.com",
      "name": "Jane Smith",
      "department": "Engineering",
      "role": "member",
      "status": "active",
      "last_active_at": "2025-01-15T09:45:00Z",
      "created_at": "2024-06-01T00:00:00Z",
      "updated_at": "2025-01-15T09:45:00Z"
    }
  ],
  "next_cursor": "eyJpZCI6InUxYTJiM2M0In0",
  "has_more": true,
  "total_count": 214
}

User object

string

Unique user identifier (UUID).

string

Organization this user belongs to.

string

User’s email address.

string

User’s full name.

string

Department name. null if not assigned.

string

Role within the organization (e.g., member, admin).

string

Account status: active, inactive, or suspended. Suspended users have had their LLM access revoked via lockout.

string

ISO 8601 timestamp of the user’s most recent LLM activity. null if no activity recorded yet.

string

ISO 8601 creation timestamp.

string

ISO 8601 last-updated timestamp.

Combine this endpoint with GET /v1/usage — filter usage by user_id to get a per-user breakdown of token consumption.

Overview

Endpoints

List users

Request

Response

User object

​List users

​Request

​Response

​User object

List users

Request

Response

User object