Skip to main content
GET
https://api.voxmind.ai
/
organisations
/
{orgId}
/
api-tokens
# 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"

{
  "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"
    }
  ]
}

​
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

​
orgId
string
required
Your organisation’s unique identifier.

​
Query Parameters

​
filter
string
Comma-separated filter conditions. Supports =, !=, and comparators gt, gte, lt, lte, like, ilike.Example: filter=enabled=true,friendly_name=like:production%
​
sort
string
Comma-separated sort fields with direction. Example: sort=created_at:desc,friendly_name:asc
​
per_page
integer
default:"100"
Number of results per page. Maximum 300.
​
page
integer
default:"1"
Page number. Check the X-Total-Pages response header for the total number of pages.
# 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"

{
  "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"
    }
  ]
}