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

# Get Monthly Summary

> Get monthly energy summary and cost calculation.

Returns the monthly energy totals and optional cost calculation for a specific MaBiS-Zählpunkt. Uses the latest version (by message_date).

Args:     mabis_zp_id: MaBiS-Zählpunkt identifier     bilanzierungsmonat: Settlement month (first day of month)     tso_area: TSO control area EIC (required for cost calculation)

Returns:     Monthly summary with energy and optional cost data



## OpenAPI

````yaml /openapi.json get /schedule-management/v1/mabis/energy-volumes/{mabis_zp_id}/monthly-summary
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/{mabis_zp_id}/monthly-summary:
    get:
      tags:
        - mabis
      summary: Get Monthly Summary
      description: >-
        Get monthly energy summary and cost calculation.


        Returns the monthly energy totals and optional cost calculation for a
        specific MaBiS-Zählpunkt. Uses the latest version (by message_date).


        Args:     mabis_zp_id: MaBiS-Zählpunkt identifier    
        bilanzierungsmonat: Settlement month (first day of month)     tso_area:
        TSO control area EIC (required for cost calculation)


        Returns:     Monthly summary with energy and optional cost data
      operationId: >-
        get_monthly_summary_schedule_management_v1_mabis_energy_volumes__mabis_zp_id__monthly_summary_get
      parameters:
        - description: MaBiS-Zaehlpunkt identifier.
          in: path
          name: mabis_zp_id
          required: true
          schema:
            description: MaBiS-Zaehlpunkt identifier.
            title: Mabis Zp Id
            type: string
        - description: Settlement month (YYYY-MM-DD, first day of month)
          in: query
          name: bilanzierungsmonat
          required: true
          schema:
            description: Settlement month (YYYY-MM-DD, first day of month)
            format: date
            title: Bilanzierungsmonat
            type: string
        - description: TSO control area (required for cost calculation)
          in: query
          name: tso_area
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: TSO control area (required for cost calculation)
            title: Tso Area
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonthlySummaryResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    MonthlySummaryResponse:
      description: Combined monthly summary with energy and cost.
      properties:
        cost:
          anyOf:
            - $ref: '#/components/schemas/MonthlyCostResponse'
            - type: 'null'
          description: Cost calculation
        energy:
          anyOf:
            - $ref: '#/components/schemas/MonthlyEnergySummaryResponse'
            - type: 'null'
          description: Energy summary
      title: MonthlySummaryResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    MonthlyCostResponse:
      description: Response model for monthly cost calculation.
      properties:
        aggregation_object_uid:
          anyOf:
            - type: string
            - type: 'null'
          description: Linked aggregation object UID
          title: Aggregation Object Uid
        average_price_eur_mwh:
          description: Average price EUR/MWh
          title: Average Price Eur Mwh
          type: number
        bilanzierungsmonat:
          description: Settlement month (YYYY-MM-DD)
          title: Bilanzierungsmonat
          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
        missing_prices_count:
          description: Intervals without price data
          title: Missing Prices Count
          type: integer
        total_cost_eur:
          description: Total cost in EUR
          title: Total Cost Eur
          type: number
        total_energy_mwh:
          description: Total energy in MWh
          title: Total Energy Mwh
          type: number
        tso_area:
          description: TSO control area
          title: Tso Area
          type: string
      required:
        - average_price_eur_mwh
        - bilanzierungsmonat
        - interval_count
        - mabis_zp_id
        - missing_prices_count
        - total_cost_eur
        - total_energy_mwh
        - tso_area
      title: MonthlyCostResponse
      type: object
    MonthlyEnergySummaryResponse:
      description: Response model for monthly energy summary.
      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
        data_status:
          description: MaBiS data status
          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: Version timestamp (ISO datetime)
          title: Message Date
          type: string
        mscons_message_id:
          description: Version identifier
          title: Mscons Message Id
          type: string
        resolution:
          description: Resolution
          title: Resolution
          type: string
        total_kwh:
          description: Total energy in kWh
          title: Total Kwh
          type: number
        total_mwh:
          description: Total energy in MWh
          title: Total Mwh
          type: number
        unit:
          description: Unit
          title: Unit
          type: string
      required:
        - bilanzierungsmonat
        - data_status
        - interval_count
        - mabis_zp_id
        - message_date
        - mscons_message_id
        - resolution
        - total_kwh
        - total_mwh
        - unit
      title: MonthlyEnergySummaryResponse
      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

````