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

# Procurement, Ausgleichsenergie, customers and Aufschlag of a period

> In kWh and EUR, per day and summed: the Fahrplan bought and sold at
the day-ahead spot price, the Ausgleichsenergie to pay, the customers'
quantity (Ist, the Fahrplan until it arrives) and its spot value, the
total cost, and the Aufschlag per customer kWh that covers the
Ausgleichsenergie beyond the spot value of the deviation. At most 31
days.



## OpenAPI

````yaml /setup/internal-openapi.json get /v1/process/kalkulation
openapi: 3.1.0
info:
  title: n:lead Scheduling Bridge — Internal API
  version: 0.4.0
  description: >-
    Internal API of the n:lead scheduling bridge: the process endpoints that
    drive the day-ahead pipeline (aggregate, publish the open position, submit
    schedules, generate forecasts, orchestrate), the operator console endpoints,
    and the read-only operator-app endpoints under /v1/mobile. The process and
    console endpoints require the process API key, /v1/mobile a device key of
    the mobile scope; not for customer use.
servers:
  - url: https://{host}
    description: Deployed service
    variables:
      host:
        default: api.energy.nlead.ch
        description: >-
          The service hostname - n:lead provides it (see the Base URL on the API
          introduction page)
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /v1/process/kalkulation:
    get:
      summary: Procurement, Ausgleichsenergie, customers and Aufschlag of a period
      description: |-
        In kWh and EUR, per day and summed: the Fahrplan bought and sold at
        the day-ahead spot price, the Ausgleichsenergie to pay, the customers'
        quantity (Ist, the Fahrplan until it arrives) and its spot value, the
        total cost, and the Aufschlag per customer kWh that covers the
        Ausgleichsenergie beyond the spot value of the deviation. At most 31
        days.
      operationId: get_kalkulation_v1_process_kalkulation_get
      parameters:
        - name: von
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: first day, default the 1st of bis' month
            title: Von
          description: first day, default the 1st of bis' month
        - name: bis
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: last day, default yesterday
            title: Bis
          description: last day, default yesterday
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Kalkulation V1 Process Kalkulation Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      description: OIDC access token (Auth0 M2M)
      scheme: bearer

````

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