> ## 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 Clearing Period > Get detailed [Clearing Period](/api-reference/settlement-management/models/clearing-period) with aggregated summary. Returns the clearing period header plus counts of settlements, objections, and messages, the total imbalance, and the next upcoming MaBiS deadline (preliminary at M+18 WT or final at M+42 WT). ## OpenAPI ````yaml /openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid} 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/{uid}: get: tags: - mabis summary: Get Clearing Period description: >- Get detailed [Clearing Period](/api-reference/settlement-management/models/clearing-period) with aggregated summary. Returns the clearing period header plus counts of settlements, objections, and messages, the total imbalance, and the next upcoming MaBiS deadline (preliminary at M+18 WT or final at M+42 WT). operationId: >- get_clearing_period_schedule_management_v1_mabis_clearing_periods__uid__get parameters: - description: Clearing period unique identifier. in: path name: uid required: true schema: description: Clearing period unique identifier. format: uuid title: Uid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ClearingPeriodSummaryResponse' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error components: schemas: ClearingPeriodSummaryResponse: description: >- Summary view for a clearing period including counts, totals, and the next deadline. properties: clearing_period: $ref: '#/components/schemas/ClearingPeriodResponse' description: The clearing period details. deadline_type: anyOf: - type: string - type: 'null' description: >- Type of the upcoming deadline: `preliminary`, `objection`, or `final`. examples: - preliminary - objection - final title: Deadline Type message_count: description: Number of EDIFACT messages exchanged for this period. examples: - 5 title: Message Count type: integer objection_count: description: Number of objections filed for this period. examples: - 0 - 2 title: Objection Count type: integer settlement_count: description: Number of daily settlement records in this period. examples: - 28 - 31 title: Settlement Count type: integer total_imbalance_cost_eur: anyOf: - type: number - type: 'null' description: Total imbalance cost in EUR. title: Total Imbalance Cost Eur total_imbalance_mwh: anyOf: - type: number - type: 'null' description: Total imbalance energy in MWh. title: Total Imbalance Mwh upcoming_deadline: anyOf: - type: string - type: 'null' description: Next approaching deadline as ISO 8601 datetime. examples: - '2026-02-25T23:59:59+01:00' title: Upcoming Deadline required: - clearing_period - message_count - objection_count - settlement_count title: ClearingPeriodSummaryResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError 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 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 ````