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

# API-Tokens auflisten

> Alle API-Tokens des angemeldeten Benutzers mit Beschreibung, Ablaufdatum, letzter Verwendung und Widerrufszeitpunkt. Der Token-Klartext ist hier nie enthalten.



## OpenAPI

````yaml /api-reference/openapi.json get /user/api-tokens
openapi: 3.1.0
info:
  title: NETZFABRIK API
  description: >-
    REST-API der NETZFABRIK-Plattform für Domains, DNS, Cloud-Server, Webspaces,
    E-Mail-Dienste und Konto. Authentifizierung per JWT (Authorization: Bearer)
    oder API-Token (X-API-TOKEN).
  termsOfService: https://www.netzfabrik.com/tos
  contact:
    name: NETZFABRIK GmbH
    url: https://www.netzfabrik.com
    email: info@netzfabrik.com
  license:
    name: Proprietary
    url: https://www.netzfabrik.com/license
  version: 2026-11-19-9237c1a3
servers:
  - url: https://api.netzfabrik.com
security:
  - JWT: []
  - ApiToken: []
tags:
  - name: Login
  - name: Zwei-Faktor-Authentifizierung
  - name: Passkeys
  - name: Benutzer
  - name: Konten
  - name: Kunden
  - name: Verträge
  - name: Rechnungen
  - name: Support-Tickets
  - name: Domains
  - name: Domain-Bestellungen
  - name: Premium-Domains
  - name: Inhaberwechsel
  - name: Handles (Kontakte)
  - name: Handle-Verifizierung
  - name: TLD-Daten
  - name: Domain-Preise
  - name: Preislisten-Vorlagen
  - name: Preislisten-Versionen
  - name: Preis-Überschreibungen
  - name: Preisänderungen
  - name: Domain-Aktionen
  - name: Öffentliche Preislisten
  - name: Domain-Reseller
  - name: DNS-Zonen
  - name: DNS-Records
  - name: Weiterleitungen
  - name: Cloud-Server
  - name: Cloud-Server-Vorlagen
  - name: Regionen
  - name: SSH-Keys
  - name: ISO-Images
  - name: Anwendungen
  - name: Webspaces
  - name: Webspace-Tarife
  - name: Object Storage
  - name: E-Mail-Protection
  - name: E-Mail-Security
  - name: E-Mail-Archiv
  - name: Colocation
  - name: Racks
  - name: Stromzuführungen
  - name: Interconnections
  - name: VLANs
  - name: Traffic
paths:
  /user/api-tokens:
    get:
      tags:
        - Benutzer
      summary: API-Tokens auflisten
      description: >-
        Alle API-Tokens des angemeldeten Benutzers mit Beschreibung,
        Ablaufdatum, letzter Verwendung und Widerrufszeitpunkt. Der
        Token-Klartext ist hier nie enthalten.
      operationId: getApiTokens
      parameters:
        - name: page
          in: query
          description: The collection page number
          required: false
          deprecated: false
          schema:
            type: integer
            default: 1
          style: form
          explode: true
        - $ref: '#/components/parameters/CustomerId'
      responses:
        '200':
          description: ApiToken collection
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/ApiToken-api_token.read_timestampable.created_at.read_timestampable.updated_at.read
components:
  parameters:
    CustomerId:
      name: X-Customer-Id
      in: header
      required: false
      description: >-
        Optionaler Kundenkontext. Ohne Header arbeitet die Anfrage im
        Standard-Kunden des angemeldeten Benutzers. Mit der ID eines anderen
        Kunden handelt die Anfrage in dessen Kontext: Listen, Lese- und
        Schreibzugriffe beziehen sich dann auf diesen Kunden.


        Erlaubt sind der eigene Kunde, jeder Unterkunde im eigenen Teilbaum
        (Reseller handelt für seinen Endkunden) sowie Kunden, in denen der
        Benutzer selbst Mitglied ist. Übergeordnete oder fremde Kunden werden
        mit `403 Forbidden` abgewiesen, eine unbekannte ID ebenfalls.


        Die IDs der erreichbaren Kunden liefern `GET /user/customers` und `GET
        /customers/{id}/children`.
      schema:
        type: string
        example: 01JD4Q8W3N6Y2K5T7R9V0B1C2D
  schemas:
    ApiToken-api_token.read_timestampable.created_at.read_timestampable.updated_at.read:
      type: object
      properties:
        id:
          readOnly: true
          example: A1B2C3D4E5F6G7H8I9J0
          type: string
        tokenPrefix:
          readOnly: true
          description: >-
            First characters of the secret, to recognise the token. The full
            secret is only shown once on creation.
          example: api_1a2b3c4d
          type: string
        scope:
          description: 'Scope of the token: read (GET/HEAD/OPTIONS only) or write.'
          example: read
          type: string
          enum:
            - read
            - write
        description:
          description: Description of the API token
          example: My API token
          type:
            - string
            - 'null'
        expiresAt:
          description: >-
            Date and time when the API token expires. If null, the token never
            expires.
          example: '2021-01-01T00:00:00+00:00'
          type:
            - string
            - 'null'
          format: date-time
        revokedAt:
          readOnly: true
          description: >-
            Date and time when the API token was revoked. If null, the token is
            active.
          type:
            - string
            - 'null'
          format: date-time
        lastUsedAt:
          readOnly: true
          description: Date and time when the API token was last used.
          type:
            - string
            - 'null'
          format: date-time
        lastUsedIp:
          readOnly: true
          description: Client IP address of the last recorded use.
          example: 203.0.113.7
          type:
            - string
            - 'null'
        mfaProvenAt:
          description: >-
            Date and time of the second factor that was proven when this token
            was issued. If null, no factor was proven.
          type:
            - string
            - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        customerId:
          readOnly: true
          description: >-
            Customer the token is bound to. Null if the membership was removed
            (the token no longer works).
          example: 01HXYZ...
          type:
            - string
            - 'null'
        customerName:
          readOnly: true
          description: Name of the customer the token is bound to.
          example: Acme GmbH
          type:
            - string
            - 'null'
  securitySchemes:
    JWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access-Token aus `POST /auth/login` (E-Mail und Passwort), gesendet als
        `Authorization: Bearer <token>`.


        Das Token ist zeitlich begrenzt gültig. Mit dem `refresh_token` aus
        derselben Antwort holt `POST /auth/token/refresh` ein neues Token-Paar,
        ohne das Passwort erneut zu senden; `POST /auth/token/invalidate` macht
        den Refresh-Token beim Abmelden ungültig.


        Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert
        der Login statt des Token-Paars `mfaRequired: true` bzw.
        `mfaEnrollmentRequired: true` und ein kurzlebiges `preAuthToken`. Mit
        diesem Token (ebenfalls als Bearer) wird der zweite Faktor über `POST
        /auth/2fa/verify` bestätigt; erst danach gibt es das volle Token-Paar.
    ApiToken:
      type: apiKey
      in: header
      name: X-API-TOKEN
      description: >-
        Persönlicher API-Token für Skripte, CI/CD und
        Server-zu-Server-Integrationen, gesendet im Header `X-API-TOKEN:
        <token>`.


        Tokens werden im Kundenpanel unter **Einstellungen → Sicherheit**
        angelegt oder per `POST /user/api-tokens` mit einem gültigen JWT. Der
        Klartext erscheint nur einmal in der Antwort beim Anlegen. Ein Token
        handelt mit den Rechten des Benutzers, der ihn erstellt hat, kann ein
        Ablaufdatum haben und wird mit `DELETE /user/api-tokens/{id}` sofort
        widerrufen.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.