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

# Wirksame Domainpreise abrufen

> Alle TLDs mit dem Preis, den der aktuelle Kunde bezahlt (Preisliste, Überschreibungen und laufende Aktionen sind eingerechnet). Beträge in Cent. Mit `customerId` löst ein Reseller die Preise eines Unterkunden auf.



## OpenAPI

````yaml /api-reference/openapi.json get /domains/prices
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:
  /domains/prices:
    get:
      tags:
        - Domain-Preise
      summary: Wirksame Domainpreise abrufen
      description: >-
        Alle TLDs mit dem Preis, den der aktuelle Kunde bezahlt (Preisliste,
        Überschreibungen und laufende Aktionen sind eingerechnet). Beträge in
        Cent. Mit `customerId` löst ein Reseller die Preise eines Unterkunden
        auf.
      operationId: getEffectiveDomainPrices
      parameters:
        - name: customerId
          in: query
          description: >-
            Preise im Kontext dieses Kunden (eigener Kunde oder Unterkunde)
            auflösen.
          required: false
          deprecated: false
          schema:
            type: string
          style: form
          explode: true
        - $ref: '#/components/parameters/CustomerId'
      responses:
        '200':
          description: Wirksame Preise je TLD.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        tld:
                          type: string
                          example: de
                        active:
                          type: boolean
                          description: '`false`: für diese TLD ist kein Preis auflösbar.'
                        price:
                          oneOf:
                            - type: object
                              properties:
                                netPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                grossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                setupNetPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                setupGrossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                renewalNetPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                renewalGrossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                transferNetPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                transferGrossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                restoreNetPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                restoreGrossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                tradeNetPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                                tradeGrossPrice:
                                  type: object
                                  properties:
                                    amount:
                                      type: integer
                                      description: Betrag in Cent.
                                      example: 1190
                                    currency:
                                      example: EUR
                                      type: string
                            - type: 'null'
                        promotion:
                          oneOf:
                            - type: object
                              properties:
                                name:
                                  type: string
                                discountPercent:
                                  type:
                                    - number
                                    - 'null'
                                promoNetPrice:
                                  type: integer
                                promoGrossPrice:
                                  type: integer
                                regularNetPrice:
                                  type: integer
                                regularGrossPrice:
                                  type: integer
                                action:
                                  type: string
                                  description: >-
                                    Aktion, auf die der Aktionspreis wirkt, z.
                                    B. `registration` oder `transfer`.
                                endsAt:
                                  type: string
                                  format: date-time
                            - type: 'null'
        '403':
          description: Kein Zugriff auf die Preise dieses Kunden.
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
  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.