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

# List API Tokens

> Retrieve all API tokens for your organisation. Supports filtering, sorting, and pagination.

## Overview

Returns a paginated list of all API tokens associated with your organisation. Use this to audit active tokens, find tokens that haven't been used recently, and identify tokens that should be rotated or revoked.

Token values are never returned in list or get responses — only metadata. The raw bearer token string is only ever shown once, at creation time.

## Path Parameters

<ParamField path="orgId" type="string" required>
  Your organisation's unique identifier.
</ParamField>

## Query Parameters

<ParamField query="filter" type="string">
  Comma-separated filter conditions. Supports `=`, `!=`, and comparators `gt`, `gte`, `lt`, `lte`, `like`, `ilike`.

  Example: `filter=enabled=true,friendly_name=like:production%`
</ParamField>

<ParamField query="sort" type="string">
  Comma-separated sort fields with direction. Example: `sort=created_at:desc,friendly_name:asc`
</ParamField>

<ParamField query="per_page" type="integer" default="100">
  Number of results per page. Maximum 300.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number. Check the `X-Total-Pages` response header for the total number of pages.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  # List all enabled tokens, newest first
  curl -X GET "https://api.voxmind.ai/organisations/42/api-tokens?filter=enabled=true&sort=created_at:desc" \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Accept: application/json"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.voxmind.ai/organisations/42/api-tokens",
      headers={"Authorization": "Bearer YOUR_API_TOKEN"},
      params={"filter": "enabled=true", "sort": "created_at:desc", "per_page": 50}
  )
  print(resp.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.voxmind.ai/organisations/42/api-tokens?filter=enabled=true&sort=created_at:desc",
    { headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
  );
  const tokens = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "results": [
      {
        "id": 7,
        "subject": "org_42",
        "audience": "PUBLIC_API",
        "algorithm": "HS256",
        "friendly_name": "production-server-01",
        "expires_at": null,
        "not_before": "2025-03-01T00:00:00Z",
        "enabled": true,
        "created_at": "2025-03-01T09:00:00Z",
        "updated_at": "2025-03-01T09:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>