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

# Retrieve Contract Details

> Returns detailed information for invoices.



## OpenAPI

````yaml /lumx_openapi.yaml get /v3/user_documents/{userID}/contracts/{contractID}/
openapi: 3.0.3
info:
  title: Lumenaza external API
  version: 3.8.0 (v3)
  description: Specification of the Lumenaza external API.
servers:
  - url: https://api.lumenaza.de/
    description: Produktivserver
  - url: https://api.test.lumenaza.de/
    description: Testserver
security: []
tags:
  - name: Community Data API
    description: >-
      The API is used to retrieve master data and measurement data for a
      community. A community is defined by all customers that belong to your
      company.
paths:
  /v3/user_documents/{userID}/contracts/{contractID}/:
    get:
      tags:
        - user_documents
      summary: Retrieve Contract Details
      description: Returns detailed information for invoices.
      operationId: user_documents_contracts_list
      parameters:
        - in: path
          name: contractID
          schema:
            type: string
          required: true
        - in: path
          name: userID
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/InvoicesDate'
          description: ''
components:
  schemas:
    InvoicesDate:
      type: object
      properties:
        inv_number:
          type: string
          maxLength: 30
        inv_type:
          $ref: '#/components/schemas/InvTypeEnum'
        inv_date:
          type: string
          format: date
        doc_url:
          type: string
          maxLength: 200
        period_end_bill_date:
          type: string
          format: date
          nullable: true
          readOnly: true
          description: Last day of the invoice billing period, if the document has one.
        period_start_bill_date:
          type: string
          format: date
          nullable: true
          readOnly: true
          description: First day of the invoice billing period, if the document has one.
        invoice_amount_gross:
          type: number
          format: double
          nullable: true
          readOnly: true
          description: Gross invoice amount in euros; null for cancelled invoices.
        invoice_amount_net:
          type: number
          format: double
          nullable: true
          readOnly: true
          description: Net invoice amount in euros; null for cancelled invoices.
        transfer_amount:
          type: number
          format: double
          nullable: true
          readOnly: true
          description: Amount paid to or collected from the user in euros.
        is_cancellation:
          type: boolean
          readOnly: true
          description: Whether this invoice cancels another invoice.
        energy_amount:
          type: number
          format: double
          nullable: true
          readOnly: true
          description: Billed energy in kWh, if applicable to the document.
        payment_method:
          type: string
          nullable: true
          readOnly: true
          description: Payment method, if available for the contract.
        payment_status:
          type: string
          nullable: true
          readOnly: true
          description: Payment status, if OPOS handling is enabled.
        due_date:
          type: string
          format: date
          nullable: true
          readOnly: true
          description: Date on which payment is due, if applicable.
        paid_amount:
          type: number
          format: double
          nullable: true
          readOnly: true
          description: Amount already paid in euros, if OPOS handling is enabled.
        dunning_level:
          type: integer
          readOnly: true
          description: Current dunning level; 0 means no dunning.
      required:
        - doc_url
        - due_date
        - dunning_level
        - energy_amount
        - inv_type
        - invoice_amount_gross
        - invoice_amount_net
        - is_cancellation
        - paid_amount
        - payment_method
        - payment_status
        - period_end_bill_date
        - period_start_bill_date
        - transfer_amount
    InvTypeEnum:
      enum:
        - Abschlagsneuberechnung
        - Endabrechnung
        - Neue_Endabrechnung
        - Storno_Endabrechnung
        - Einspeisung
        - Storno_Einspeisung
        - Jahresrechnung
        - Neue_Jahresrechnung
        - Storno_Jahresrechnung
        - Monatsrechnung
        - Storno_Monatsrechnung
        - Abschlagszahlung
        - Storno_Abschlagszahlung
        - Auftragsbestätigung
        - Gutschrift
        - Korrektur
        - Korrekturrechnung
        - Lieferbestätigung
        - Salespartner
        - Stornierung
        - Zaehlerrechnung
        - Produktwechsel
        - Produktschlussrechnung
        - Storno_Produktschlussrechnung
        - Vermarktungskosten_Abrechnung
        - Strono_Vermarktungskosten_Abrechnung
        - Beschaffungskosten_Abrechnung
        - Storno_Beschaffungskosten_Abrechnung
        - Ausgleichsrechnung
        - Storno_Ausgleichsrechnung
        - Jahresübersicht
        - delivery_confirmation_consumer
        - Preisänderung
        - Zwischenabrechnung
        - Korrektur-Jahresrechnung
        - Storno_AbsRechnung
      type: string
      description: >-
        * `Abschlagsneuberechnung` - Abschlagsneuberechnung

        * `Endabrechnung` - Endabrechnung

        * `Neue_Endabrechnung` - Neue_Endabrechnung

        * `Storno_Endabrechnung` - Storno_Endabrechnung

        * `Einspeisung` - Einspeisung

        * `Storno_Einspeisung` - Storno_Einspeisung

        * `Jahresrechnung` - Jahresrechnung

        * `Neue_Jahresrechnung` - Neue_Jahresrechnung

        * `Storno_Jahresrechnung` - Storno_Jahresrechnung

        * `Monatsrechnung` - Monatsrechnung

        * `Storno_Monatsrechnung` - Storno_Monatsrechnung

        * `Abschlagszahlung` - Abschlagszahlung

        * `Storno_Abschlagszahlung` - Storno_Abschlagszahlung

        * `Auftragsbestätigung` - Auftragsbestätigung

        * `Gutschrift` - Gutschrift

        * `Korrektur` - Korrektur

        * `Korrekturrechnung` - Korrekturrechnung

        * `Lieferbestätigung` - Lieferbestätigung

        * `Salespartner` - Salespartner

        * `Stornierung` - Stornierung

        * `Zaehlerrechnung` - Zaehlerrechnung

        * `Produktwechsel` - Produktwechsel

        * `Produktschlussrechnung` - Produktschlussrechnung

        * `Storno_Produktschlussrechnung` - Storno_Produktschlussrechnung

        * `Vermarktungskosten_Abrechnung` - Vermarktungskosten_Abrechnung

        * `Strono_Vermarktungskosten_Abrechnung` -
        Strono_Vermarktungskosten_Abrechnung

        * `Beschaffungskosten_Abrechnung` - Beschaffungskosten_Abrechnung

        * `Storno_Beschaffungskosten_Abrechnung` -
        Storno_Beschaffungskosten_Abrechnung

        * `Ausgleichsrechnung` - Ausgleichsrechnung

        * `Storno_Ausgleichsrechnung` - Storno_Ausgleichsrechnung

        * `Jahresübersicht` - Jahresübersicht

        * `delivery_confirmation_consumer` - delivery_confirmation_consumer

        * `Preisänderung` - Preisänderung

        * `Zwischenabrechnung` - Zwischenabrechnung

        * `Korrektur-Jahresrechnung` - Korrektur-Jahresrechnung

        * `Storno_AbsRechnung` - Storno_AbsRechnung

````

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