Management
List API Keys
Lists user-managed API keys for the current organization management token.
GEThttps://api.tokenlab.sh/v1/management/api-keys
Overview
Returns user API keys in the organization associated with the current management token.
Notes
-
Monetary fields are USD-only.
-
System-managed keys are excluded.
Example
pageintegerquerydefault:
1Page number starting at 1.
limitintegerquerydefault:
50Page size from 1 to 100.
Request
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token"Request / Response
This page provides the OpenAPI schema and copyable request examples. Send management requests from your terminal or client with a Management Token; direct sending is not available on this page.
Response
{
"object": "list",
"data": [
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-3-7-sonnet"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1
}
}Important fields
objectstring
Always
list.dataarray
Array of API key objects.
paginationobject
Pagination metadata with
page, limit, total, and totalPages.data[].idstring
API key identifier used in follow-up Management API calls.
data[].namestring
Display name for the API key.
data[].key_prefixstring
Non-secret key prefix for display and support.
data[].statusstring
One of
active, inactive, suspended, or revoked.data[].limit_amountnumber | null
Spending cap in USD as a JSON number for display.
null means unlimited.data[].limit_amount_decimalstring | null
Exact spending cap in USD as a decimal string.
null means unlimited.data[].used_amountnumber
Accumulated usage in USD as a JSON number for display.
data[].used_amount_decimalstring
Exact accumulated usage in USD as a decimal string.
data[].modelsstring[]
Per-key model allowlist. Empty array means no additional key-level model restriction.
data[].delivery_policystring | null
auto, verified, official, null. null inherits the Workspace delivery policy.data[].expires_atstring | null
ISO timestamp when the key expires, or
null for no expiry.data[].last_used_atstring | null
ISO timestamp for the most recent use, or
null when unused.data[].created_atstring
ISO creation timestamp.
Authorization
ManagementTokenAuth AuthorizationBearer <token>
Management token authentication. Create or manage Management Tokens in Dashboard > API > Management Tokens.
In: header
Response
application/json
application/json
application/json