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

# List Energy Volumes

> List energy volumes from MSCONS messages.

Returns energy volume records stored from parsed MSCONS messages, ordered by message_date descending (latest first).

Args:     mabis_zp_id: Optional filter by MaBiS-Zählpunkt ID     aggregation_object_uid: Optional filter by linked aggregation object     bilanzierungsmonat: Optional filter by settlement month

Returns:     List of energy volume records



## OpenAPI

````yaml /openapi.json get /schedule-management/v1/mabis/energy-volumes
openapi: 3.1.0
info:
  title: Engrate API
  version: 1.0.0
servers:
  - url: https://api.engrate.io
security:
  - apiKeyAuth: []
paths:
  /schedule-management/v1/mabis/energy-volumes:
    get:
      tags:
        - mabis
      summary: List Energy Volumes
      description: >-
        List energy volumes from MSCONS messages.


        Returns energy volume records stored from parsed MSCONS messages,
        ordered by message_date descending (latest first).


        Args:     mabis_zp_id: Optional filter by MaBiS-Zählpunkt ID    
        aggregation_object_uid: Optional filter by linked aggregation object    
        bilanzierungsmonat: Optional filter by settlement month


        Returns:     List of energy volume records
      operationId: list_energy_volumes_schedule_management_v1_mabis_energy_volumes_get
      parameters:
        - description: Filter by MaBiS-ZP ID
          in: query
          name: mabis_zp_id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by MaBiS-ZP ID
            title: Mabis Zp Id
        - description: Filter by aggregation object UID
          in: query
          name: aggregation_object_uid
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: Filter by aggregation object UID
            title: Aggregation Object Uid
        - description: Filter by settlement month (YYYY-MM-DD)
          in: query
          name: bilanzierungsmonat
          required: false
          schema:
            anyOf:
              - format: date
                type: string
              - type: 'null'
            description: Filter by settlement month (YYYY-MM-DD)
            title: Bilanzierungsmonat
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/EnergyVolumeResponse'
                title: >-
                  Response List Energy Volumes Schedule Management V1 Mabis
                  Energy Volumes Get
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    EnergyVolumeResponse:
      description: Response model for energy volume records.
      properties:
        aggregation_object_uid:
          anyOf:
            - type: string
            - type: 'null'
          description: Linked aggregation object UID
          title: Aggregation Object Uid
        bilanzierungsmonat:
          description: Settlement month (YYYY-MM-DD)
          title: Bilanzierungsmonat
          type: string
        category:
          description: MSCONS category
          title: Category
          type: string
        data_status:
          description: 'MaBiS data status: pruefdaten, abrechnungsdaten'
          title: Data Status
          type: string
        interval_count:
          description: Number of intervals
          title: Interval Count
          type: integer
        mabis_zp_id:
          description: MaBiS-Zählpunkt ID
          title: Mabis Zp Id
          type: string
        message_date:
          description: Message timestamp (ISO datetime)
          title: Message Date
          type: string
        mscons_message_id:
          description: MSCONS message ID (version)
          title: Mscons Message Id
          type: string
        period_end:
          description: Period end (ISO datetime)
          title: Period End
          type: string
        period_start:
          description: Period start (ISO datetime)
          title: Period Start
          type: string
        resolution:
          description: 'Resolution: PT15M, PT30M, PT60M'
          title: Resolution
          type: string
        total_kwh:
          description: Total energy in kWh
          title: Total Kwh
          type: number
        uid:
          description: Energy volume UID
          title: Uid
          type: string
        unit:
          description: 'Unit: KWH, MWH'
          title: Unit
          type: string
      required:
        - bilanzierungsmonat
        - category
        - data_status
        - interval_count
        - mabis_zp_id
        - message_date
        - mscons_message_id
        - period_end
        - period_start
        - resolution
        - total_kwh
        - uid
        - unit
      title: EnergyVolumeResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    apiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````