List tokens

{
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "issuer": "trelent-data-ingestion",
      "subject": "my-service",
      "created_at": "2024-12-01T10:00:00Z",
      "expires_at": "2024-12-02T10:00:00Z",
      "revoked_at": null,
      "is_valid": true
    }
  ]
}

List tokens registered in the system. Requires token:list or token:* permission. By default, only valid (non-expired, non-revoked) tokens are returned.

Query parameters

uuid

Filter by specific token ID.

string

Filter by token issuer.

string

Filter by token subject.

boolean

default:"false"

Include expired and revoked tokens in results.

List all valid tokens

TypeScript
Python
cURL

// TODO: Add TypeScript SDK example for listing tokens

# TODO: Add Python SDK example for listing tokens

curl -X GET "${API_URL}/v1/token/list" \
  -H "Authorization: Bearer ${API_TOKEN}"

{
  "tokens": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "issuer": "trelent-data-ingestion",
      "subject": "my-service",
      "created_at": "2024-12-01T10:00:00Z",
      "expires_at": "2024-12-02T10:00:00Z",
      "revoked_at": null,
      "is_valid": true
    }
  ]
}

Response fields

array

List of token information objects.

Show Token object fields

uuid

Unique token identifier (JTI).

string

Token issuer claim.

string

Token subject claim.

datetime

When the token was generated.

datetime

When the token expires.

datetime

When the token was revoked, or null if still active.

boolean

Whether the token is currently valid (not expired and not revoked).

Filter by subject

cURL

curl -X GET "${API_URL}/v1/token/list?subject=my-service&include_invalid=true" \
  -H "Authorization: Bearer ${API_TOKEN}"

Getting started

Connectors

Configuration

Outputs

Jobs

Files

Admin

Query parameters

List all valid tokens

Response fields

Filter by subject

​Query parameters

​List all valid tokens

​Response fields

​Filter by subject

Query parameters

List all valid tokens

Response fields

Filter by subject