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

# List API-nøkler

> Bruk CometAPI GET /api/token/ for å liste API-nøkler for den autentiserte kontoen med paginering.

Bruk dette endepunktet til å liste API-nøkler som tilhører den autentiserte CometAPI-kontoen. De nyeste nøklene returneres først.

<Note>
  Generer et personlig tilgangstoken på [Console → Personal Settings](https://www.cometapi.com/console/personal), og send det deretter som den rå `Authorization`-headerverdien. Ikke prefiks det med `Bearer`.
</Note>

## Paginering

| Query parameter | Beskrivelse                                                 |
| --------------- | ----------------------------------------------------------- |
| `p`             | Sidenummer. Standard er `1`.                                |
| `page_size`     | Elementer per side. Verdier over `100` begrenses til `100`. |

## API-nøkkelstatus

| Status | Betydning  |
| ------ | ---------- |
| `1`    | Aktivert   |
| `2`    | Deaktivert |
| `3`    | Utløpt     |
| `4`    | Oppbrukt   |

## Returnerte felt

| Field                  | Type           | Beskrivelse                                                                                                                                                                                                 |
| ---------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                   | integer        | Numerisk API-nøkkel-ID. Bruk denne verdien med [Hent én API-nøkkel](./get-api-key), [Oppdater en API-nøkkel](./update-api-key) og [Slett en API-nøkkel](./delete-api-key).                                  |
| `key`                  | string         | API-nøkkelverdien som returneres av administrasjons-API-et. Behandle den som en hemmelighet, og bruk den som `Authorization: Bearer $COMETAPI_KEY` for modellforespørsler.                                  |
| `status`               | integer        | Operasjonell status. Bare `1` betyr at nøkkelen er aktivert for modellforespørsler.                                                                                                                         |
| `name`                 | string         | Brukervennlig visningsnavn for nøkkelen.                                                                                                                                                                    |
| `created_time`         | integer        | Unix-tidsstempel i sekunder for når nøkkelen ble opprettet.                                                                                                                                                 |
| `accessed_time`        | integer        | Unix-tidsstempel i sekunder for når nøkkelen sist ble brukt.                                                                                                                                                |
| `expired_time`         | integer        | Unix-tidsstempel i sekunder for når nøkkelen utløper. `-1` betyr ingen utløpstid.                                                                                                                           |
| `remain_quota`         | integer        | Gjenstående kvote i CometAPI interne kvoteenheter.                                                                                                                                                          |
| `used_quota`           | integer        | Kvote som allerede er brukt av denne nøkkelen i CometAPI interne kvoteenheter.                                                                                                                              |
| `unlimited_quota`      | boolean        | Om nøkkelen omgår kontroller av gjenstående kvote.                                                                                                                                                          |
| `model_limits_enabled` | boolean        | Om modellbegrensninger er aktive for denne nøkkelen.                                                                                                                                                        |
| `model_limits`         | string         | Kommaseparerte model ID-er som er tillatt for denne nøkkelen når `model_limits_enabled` er `true`. Tom betyr ingen konfigurert modelliste.                                                                  |
| `allow_ips`            | string or null | IP-tillatelsesliste som én streng separert med linjeskift. Hver oppføring kan være én enkelt IPv4-adresse, én enkelt IPv6-adresse, IPv4 CIDR eller IPv6 CIDR. `null` eller `""` betyr ingen IP-begrensning. |
| `group`                | string         | Kontogruppebegrensning. Tom betyr ingen eksplisitt gruppebegrensning.                                                                                                                                       |
| `cross_group_retry`    | boolean        | Om retry på tvers av grupper er aktivert for automatisk grupperuting.                                                                                                                                       |


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

````