> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toktra.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> List users in your organization.

## List users

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

```bash theme={null}
GET /v1/users
```

<ParamField query="cursor" type="string">
  Opaque pagination cursor. Pass `next_cursor` from a previous response. Omit for the first page.
</ParamField>

<ParamField query="limit" type="integer" default="25">
  Maximum items per page (1–100).
</ParamField>

<ParamField query="status" type="string">
  Filter by account status: `active`, `inactive`, or `suspended`.
</ParamField>

<ParamField query="department" type="string">
  Filter by department name (e.g., `engineering`).
</ParamField>

### Request

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

### Response

```json theme={null}
{
  "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

<ResponseField name="id" type="string">
  Unique user identifier (UUID).
</ResponseField>

<ResponseField name="org_id" type="string">
  Organization this user belongs to.
</ResponseField>

<ResponseField name="email" type="string">
  User's email address.
</ResponseField>

<ResponseField name="name" type="string">
  User's full name.
</ResponseField>

<ResponseField name="department" type="string">
  Department name. `null` if not assigned.
</ResponseField>

<ResponseField name="role" type="string">
  Role within the organization (e.g., `member`, `admin`).
</ResponseField>

<ResponseField name="status" type="string">
  Account status: `active`, `inactive`, or `suspended`. Suspended users have had their LLM access revoked via lockout.
</ResponseField>

<ResponseField name="last_active_at" type="string">
  ISO 8601 timestamp of the user's most recent LLM activity. `null` if no activity recorded yet.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 last-updated timestamp.
</ResponseField>

<Tip>
  Combine this endpoint with [GET /v1/usage](/api/usage) — filter usage by `user_id` to get a per-user breakdown of token consumption.
</Tip>