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

# Create Clearing Period

> Create a new [Clearing Period](/api-reference/settlement-management/models/clearing-period).

A clearing period represents one Bilanzierungsmonat for a Bilanzkreis. The deadlines should match the MaBiS calendar: preliminary at M+18 WT, objection window closing at M+30 WT, and final settlement at M+42 WT. Use `GET /mabis/clearing-calendar` to calculate the exact dates for a given month.



## OpenAPI

````yaml /openapi.json post /schedule-management/v1/mabis/clearing-periods
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/clearing-periods:
    post:
      tags:
        - mabis
      summary: Create Clearing Period
      description: >-
        Create a new [Clearing
        Period](/api-reference/settlement-management/models/clearing-period).


        A clearing period represents one Bilanzierungsmonat for a Bilanzkreis.
        The deadlines should match the MaBiS calendar: preliminary at M+18 WT,
        objection window closing at M+30 WT, and final settlement at M+42 WT.
        Use `GET /mabis/clearing-calendar` to calculate the exact dates for a
        given month.
      operationId: >-
        create_clearing_period_schedule_management_v1_mabis_clearing_periods_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClearingPeriodCreateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClearingPeriodResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ClearingPeriodCreateRequest:
      additionalProperties: false
      description: Request to create a clearing period.
      properties:
        bilanzierungsmonat:
          description: >-
            First day of the billing month (YYYY-MM-DD). Example: '2026-01-01'
            for January 2026. Use `GET /mabis/clearing-calendar` to compute the
            MaBiS deadlines for this month.
          format: date
          title: Bilanzierungsmonat
          type: string
        bilanzkreis_eic:
          description: >-
            Balance group (Bilanzkreis) EIC X code (16-character organization
            code, starts with '11X'). Registered with the TSO as the BRP
            identifier.
          title: Bilanzkreis Eic
          type: string
        final_deadline:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            Final billing deadline (ISO 8601 datetime). Corresponds to M+42 WT
            per BK6-24-174.
          title: Final Deadline
        objection_deadline:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            Objection window closing deadline (ISO 8601 datetime). Corresponds
            to M+30 WT — after this date objections can no longer be submitted.
          title: Objection Deadline
        preliminary_deadline:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            Preliminary billing deadline (ISO 8601 datetime with timezone).
            Corresponds to M+18 WT per BK6-24-174. Example:
            '2026-02-25T23:59:59+01:00'.
          title: Preliminary Deadline
      required:
        - bilanzierungsmonat
        - bilanzkreis_eic
      title: ClearingPeriodCreateRequest
      type: object
    ClearingPeriodResponse:
      description: >-
        A [Clearing
        Period](/api-reference/settlement-management/models/clearing-period)
        representing one settlement month for a balance group.
      properties:
        bilanzierungsmonat:
          description: First day of the settlement month in ISO 8601 format.
          examples:
            - '2026-01-01'
          title: Bilanzierungsmonat
          type: string
        bilanzkreis_eic:
          description: Balance group (Bilanzkreis) EIC X code.
          examples:
            - 11XEXAMPLE-BKV-A
          title: Bilanzkreis Eic
          type: string
        created_ts:
          description: ISO 8601 datetime when this clearing period was created.
          examples:
            - '2026-02-01T00:00:00+00:00'
          title: Created Ts
          type: string
        final_deadline:
          anyOf:
            - type: string
            - type: 'null'
          description: Final billing deadline (M+42 WT) as ISO 8601 datetime.
          examples:
            - '2026-03-31T23:59:59+02:00'
          title: Final Deadline
        last_modified_ts:
          description: ISO 8601 datetime of the most recent modification.
          examples:
            - '2026-02-25T10:00:00+00:00'
          title: Last Modified Ts
          type: string
        objection_deadline:
          anyOf:
            - type: string
            - type: 'null'
          description: Objection window closing deadline (M+30 WT) as ISO 8601 datetime.
          examples:
            - '2026-03-13T23:59:59+01:00'
          title: Objection Deadline
        org_uid:
          description: Organization that owns this clearing period.
          title: Org Uid
          type: string
        preliminary_deadline:
          anyOf:
            - type: string
            - type: 'null'
          description: Preliminary billing deadline (M+18 WT) as ISO 8601 datetime.
          examples:
            - '2026-02-25T23:59:59+01:00'
          title: Preliminary Deadline
        status:
          description: >-
            Clearing status: `open`, `preliminary`, `objection`, `final`, or
            `closed`.
          examples:
            - open
            - preliminary
            - final
          title: Status
          type: string
        total_imbalance_cost_eur:
          anyOf:
            - type: number
            - type: 'null'
          description: Total imbalance cost in EUR based on reBAP prices.
          examples:
            - 1875
          title: Total Imbalance Cost Eur
        total_imbalance_mwh:
          anyOf:
            - type: number
            - type: 'null'
          description: Total imbalance energy in MWh across all settlement days.
          examples:
            - 12.5
          title: Total Imbalance Mwh
        uid:
          description: Unique identifier for this clearing period.
          examples:
            - c5d6e7f8-a9b0-4c1d-8e2f-3a4b5c6d7e8f
          title: Uid
          type: string
      required:
        - bilanzierungsmonat
        - bilanzkreis_eic
        - created_ts
        - last_modified_ts
        - org_uid
        - status
        - uid
      title: ClearingPeriodResponse
      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

````