> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API anahtarlarını listele

> Kimliği doğrulanmış hesap için sayfalamayla API anahtarlarını listelemek üzere CometAPI GET /api/token/ uç noktasını kullanın.

Kimliği doğrulanmış CometAPI hesabına ait API anahtarlarını listelemek için bu uç noktayı kullanın. En yeni anahtarlar önce döndürülür.

<Note>
  [Console → Personal Settings](https://www.cometapi.com/console/personal) üzerinden bir kişisel erişim token'ı oluşturun, ardından bunu ham `Authorization` başlık değeri olarak gönderin. Başına `Bearer` eklemeyin.
</Note>

## Sayfalama

| Query parameter | Description                                                                   |
| --------------- | ----------------------------------------------------------------------------- |
| `p`             | Sayfa numarası. Varsayılan değer `1`'dir.                                     |
| `page_size`     | Sayfa başına öğe sayısı. `100` üzerindeki değerler `100` ile sınırlandırılır. |

## API anahtarı durumu

| Status | Meaning       |
| ------ | ------------- |
| `1`    | Etkin         |
| `2`    | Devre dışı    |
| `3`    | Süresi dolmuş |
| `4`    | Tükenmiş      |

## Döndürülen alanlar

| Field                  | Type           | Description                                                                                                                                                                                                      |
| ---------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                   | integer        | Sayısal API anahtarı kimliği. Bu değeri [Tek bir API anahtarı getir](./get-api-key), [Bir API anahtarını güncelle](./update-api-key) ve [Bir API anahtarını sil](./delete-api-key) ile kullanın.                 |
| `key`                  | string         | Yönetim API'si tarafından döndürülen API anahtarı değeri. Bunu gizli bir bilgi olarak değerlendirin ve model istekleri için `Authorization: Bearer $COMETAPI_KEY` şeklinde kullanın.                             |
| `status`               | integer        | Operasyonel durum. Yalnızca `1`, anahtarın model istekleri için etkin olduğu anlamına gelir.                                                                                                                     |
| `name`                 | string         | Anahtar için kullanıcı tarafından okunabilir görünen ad.                                                                                                                                                         |
| `created_time`         | integer        | Anahtarın oluşturulduğu zamanı gösteren, saniye cinsinden Unix zaman damgası.                                                                                                                                    |
| `accessed_time`        | integer        | Anahtarın en son kullanıldığı zamanı gösteren, saniye cinsinden Unix zaman damgası.                                                                                                                              |
| `expired_time`         | integer        | Anahtarın süresinin dolduğu zamanı gösteren, saniye cinsinden Unix zaman damgası. `-1`, süresinin dolmadığı anlamına gelir.                                                                                      |
| `remain_quota`         | integer        | CometAPI dahili kota birimleri cinsinden kalan kota.                                                                                                                                                             |
| `used_quota`           | integer        | Bu anahtar tarafından CometAPI dahili kota birimleri cinsinden zaten tüketilmiş kota.                                                                                                                            |
| `unlimited_quota`      | boolean        | Anahtarın kalan kota kontrollerini atlayıp atlamadığı.                                                                                                                                                           |
| `model_limits_enabled` | boolean        | Bu anahtar için model kısıtlamalarının etkin olup olmadığı.                                                                                                                                                      |
| `model_limits`         | string         | `model_limits_enabled` değeri `true` olduğunda, bu anahtarın izin verdiği virgülle ayrılmış model ID listesi. Boş olması, yapılandırılmış bir model listesi olmadığı anlamına gelir.                             |
| `allow_ips`            | string or null | Yeni satırlarla ayrılmış tek bir string olarak IP izin listesi. Her giriş tek bir IPv4 adresi, tek bir IPv6 adresi, IPv4 CIDR veya IPv6 CIDR olabilir. `null` veya `""`, IP kısıtlaması olmadığı anlamına gelir. |
| `group`                | string         | Hesap grubu kısıtlaması. Boş olması, açık bir grup kısıtlaması olmadığı anlamına gelir.                                                                                                                          |
| `cross_group_retry`    | boolean        | Otomatik grup yönlendirmesi için gruplar arası yeniden denemenin etkin olup olmadığı.                                                                                                                            |


## OpenAPI

````yaml api/openapi/api-keys/list-api-keys.openapi.json GET /api/token/
openapi: 3.1.0
info:
  title: List API Keys
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - accessTokenAuth: []
paths:
  /api/token/:
    get:
      summary: List API keys
      description: >-
        List API keys for the authenticated account. The newest keys are
        returned first.
      operationId: listApiKeys
      parameters:
        - name: p
          in: query
          required: false
          description: Page number to return. Defaults to `1`.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          required: false
          description: >-
            Number of keys per page. Values above `100` are capped at `100` by
            the backend.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: Paginated API key list.
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - message
                  - data
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    required:
                      - page
                      - page_size
                      - total
                      - items
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total:
                        type: integer
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/ApiKey'
              examples:
                success:
                  summary: API key list
                  value:
                    success: true
                    message: ''
                    data:
                      page: 1
                      page_size: 20
                      total: 1
                      items:
                        - id: 1234
                          user_id: 5678
                          key: $COMETAPI_KEY
                          status: 1
                          name: production
                          created_time: 1766102400
                          accessed_time: 1766102400
                          expired_time: -1
                          remain_quota: 100000
                          unlimited_quota: false
                          model_limits_enabled: false
                          model_limits: ''
                          allow_ips: null
                          used_quota: 0
                          group: ''
                          cross_group_retry: false
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
              -H "Authorization: your-access-token"
components:
  schemas:
    ApiKey:
      $ref: '#/components/schemas/ApiKeyObject'
    ApiKeyObject:
      type: object
      properties:
        id:
          type: integer
          description: >-
            Numeric API key ID. Use this value with the get, update, and delete
            endpoints.
          example: 1234
        user_id:
          type: integer
          description: Account user ID that owns the key.
          example: 5678
        key:
          type: string
          description: >-
            API key value returned by the management API. Treat it as a secret
            and use it as `Authorization: Bearer $COMETAPI_KEY` for model
            requests.
          example: $COMETAPI_KEY
        status:
          type: integer
          description: >-
            Operational status for the key. `1` means enabled, `2` disabled, `3`
            expired, and `4` exhausted. Only enabled keys are accepted by model
            endpoints.
          enum:
            - 1
            - 2
            - 3
            - 4
          example: 1
        name:
          type: string
          description: User-readable display name for the API key.
          example: production
          maxLength: 50
        created_time:
          type: integer
          description: Unix timestamp in seconds when the key was created.
          example: 1766102400
        accessed_time:
          type: integer
          description: >-
            Unix timestamp in seconds when the key was last used. Newly created
            keys may show the creation time until first use.
          example: 1766102400
        expired_time:
          type: integer
          description: >-
            Unix timestamp in seconds when the key expires. `-1` means no
            expiration.
          example: -1
        remain_quota:
          type: integer
          description: >-
            Remaining quota for this key in CometAPI internal quota units. When
            this reaches `0` and `unlimited_quota` is `false`, model requests
            are rejected as quota exhausted.
          example: 100000
        unlimited_quota:
          type: boolean
          description: Whether the key bypasses remaining-quota checks.
          example: false
        model_limits_enabled:
          type: boolean
          description: >-
            Whether model restrictions are active for this key. When `false`,
            `model_limits` is ignored.
          example: false
        model_limits:
          type: string
          description: >-
            Comma-separated model IDs allowed by this key when
            `model_limits_enabled` is `true`. Empty means no configured model
            list.
          example: ''
        allow_ips:
          type:
            - string
            - 'null'
          description: >-
            Optional IP allowlist stored as one newline-separated string. Each
            entry can be a single IPv4 address, single IPv6 address, IPv4 CIDR,
            or IPv6 CIDR. Example:
            `198.51.100.10\n203.0.113.0/24\n2001:db8::/32`. `null` or `""` means
            IP restrictions are disabled.
          example: |-
            198.51.100.10
            203.0.113.0/24
            2001:db8::/32
        used_quota:
          type: integer
          description: Quota already consumed by this key in CometAPI internal quota units.
          example: 0
        group:
          type: string
          description: >-
            Account group restriction for this key. Empty means no explicit
            group restriction.
          example: ''
        cross_group_retry:
          type: boolean
          description: >-
            Whether cross-group retry is enabled for automatic group routing.
            This is only meaningful when the key uses an auto-routed group such
            as `auto`.
          example: false
      additionalProperties: true
  securitySchemes:
    accessTokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Personal access token copied from CometAPI Console > Personal Settings.
        Send the raw token value; do not prefix it with `Bearer`.

````