> ## 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-sleutels weergeven

> Gebruik CometAPI GET /api/token/ om API-sleutels voor het geauthenticeerde account weer te geven met paginering.

Gebruik dit endpoint om API-sleutels weer te geven die bij het geauthenticeerde CometAPI-account horen. De nieuwste sleutels worden eerst geretourneerd.

<Note>
  Genereer een personal access token via [Console → Personal Settings](https://www.cometapi.com/console/personal) en verstuur dit vervolgens als de onbewerkte `Authorization` headerwaarde. Voeg er geen `Bearer` aan toe.
</Note>

## Paginering

| Query parameter | Beschrijving                                                    |
| --------------- | --------------------------------------------------------------- |
| `p`             | Paginanummer. Standaard `1`.                                    |
| `page_size`     | Items per pagina. Waarden boven `100` worden begrensd op `100`. |

## API-sleutelstatus

| Status | Betekenis     |
| ------ | ------------- |
| `1`    | Ingeschakeld  |
| `2`    | Uitgeschakeld |
| `3`    | Verlopen      |
| `4`    | Verbruikt     |

## Geretourneerde velden

| Field                  | Type           | Beschrijving                                                                                                                                                                                     |
| ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                   | integer        | Numerieke API-sleutel-ID. Gebruik deze waarde met [Één API-sleutel ophalen](./get-api-key), [Een API-sleutel bijwerken](./update-api-key) en [Een API-sleutel verwijderen](./delete-api-key).    |
| `key`                  | string         | API-sleutelwaarde die door de beheer-API wordt geretourneerd. Behandel deze als een geheim en gebruik deze als `Authorization: Bearer $COMETAPI_KEY` voor modelverzoeken.                        |
| `status`               | integer        | Operationele status. Alleen `1` betekent dat de sleutel is ingeschakeld voor modelverzoeken.                                                                                                     |
| `name`                 | string         | Door de gebruiker leesbare weergavenaam voor de sleutel.                                                                                                                                         |
| `created_time`         | integer        | Unix-tijdstempel in seconden waarop de sleutel is aangemaakt.                                                                                                                                    |
| `accessed_time`        | integer        | Unix-tijdstempel in seconden waarop de sleutel voor het laatst is gebruikt.                                                                                                                      |
| `expired_time`         | integer        | Unix-tijdstempel in seconden waarop de sleutel verloopt. `-1` betekent geen vervaldatum.                                                                                                         |
| `remain_quota`         | integer        | Resterend quotum in interne quota-eenheden van CometAPI.                                                                                                                                         |
| `used_quota`           | integer        | Quotum dat al door deze sleutel is verbruikt in interne quota-eenheden van CometAPI.                                                                                                             |
| `unlimited_quota`      | boolean        | Of de sleutel controles op resterend quotum omzeilt.                                                                                                                                             |
| `model_limits_enabled` | boolean        | Of modelbeperkingen actief zijn voor deze sleutel.                                                                                                                                               |
| `model_limits`         | string         | Door komma's gescheiden model ID's die door deze sleutel zijn toegestaan wanneer `model_limits_enabled` `true` is. Leeg betekent dat er geen modellijst is geconfigureerd.                       |
| `allow_ips`            | string or null | IP-toestaanlijst als één door regeleinden gescheiden string. Elke vermelding kan een enkel IPv4-adres, enkel IPv6-adres, IPv4 CIDR of IPv6 CIDR zijn. `null` of `""` betekent geen IP-beperking. |
| `group`                | string         | Beperking op accountgroep. Leeg betekent geen expliciete groepsbeperking.                                                                                                                        |
| `cross_group_retry`    | boolean        | Of opnieuw proberen over groepen heen is ingeschakeld voor automatische groeproutering.                                                                                                          |


## 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`.

````