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
Filter by specific token ID.
Include expired and revoked tokens in results.
List all valid tokens
// 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
List of token information objects. Unique token identifier (JTI).
When the token was generated.
When the token was revoked, or null if still active.
Whether the token is currently valid (not expired and not revoked).
Filter by subject
curl -X GET "${ API_URL }/v1/token/list?subject=my-service&include_invalid=true" \
-H "Authorization: Bearer ${ API_TOKEN }"