메인 콘텐츠로 건너뛰기

​
개요

현재 관리 토큰에 연결된 조직의 사용자 API 키 목록을 반환합니다.

​
주의 사항

  • 시스템 관리 key는 결과에 포함되지 않습니다.

​
예시

curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

​
요청 / 응답

정확한 스키마를 위해 위의 대화형 OpenAPI 패널을 사용하세요.

​
Response example

{
  "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-mini",
        "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

​
Important fields

​
object
string
Always list.
​
data
array
Array of API key objects.
​
pagination
object
Pagination metadata with page, limit, total, and totalPages.
​
data[].id
string
API key identifier used in follow-up Management API calls.
​
data[].name
string
Display name for the API key.
​
data[].key_prefix
string
Non-secret key prefix for display and support.
​
data[].status
string
One of active, inactive, or revoked.
​
data[].limit_amount
number | null
Spending cap in USD as a JSON number for display. null means unlimited.
​
data[].limit_amount_decimal
string | null
Exact spending cap in USD as a decimal string. null means unlimited.
​
data[].used_amount
number
Accumulated usage in USD as a JSON number for display.
​
data[].used_amount_decimal
string
Exact accumulated usage in USD as a decimal string.
​
data[].models
string[]
Per-key model allowlist. Empty array means no additional key-level model restriction.
​
data[].expires_at
string | null
ISO timestamp when the key expires, or null for no expiry.
​
data[].last_used_at
string | null
ISO timestamp for the most recent use, or null when unused.
​
data[].created_at
string
ISO creation timestamp.