Skip to main content
A clearing period represents one settlement month (Bilanzierungsmonat) for a specific balance group (Bilanzkreis). It tracks the MaBiS clearing lifecycle from initial data reception through to final billing.

​
Status lifecycle

StatusMeaning
openClearing period created, awaiting settlement data
preliminaryPreliminary billing data received (M+18 WT)
objectionWithin the objection window (M+18 to M+30 WT)
finalFinal settlement issued (M+42 WT)
closedAll processing complete, period archived

​
Deadlines

MaBiS deadlines are calculated in working days (Werktage, WT) after the end of the settlement month. Use GET /mabis/clearing-calendar to compute exact dates for any month.
DeadlineTimingPurpose
preliminary_deadlineM+18 WTPreliminary billing — first settlement figures are available
objection_deadlineM+30 WTObjection window closes — no new objections can be filed after this date
final_deadlineM+42 WTFinal billing — definitive settlement figures

A Clearing Period representing one settlement month for a balance group.

​
bilanzierungsmonat
string
required

First day of the settlement month in ISO 8601 format.

Example:

"2026-01-01"

​
bilanzkreis_eic
string
required

Balance group (Bilanzkreis) EIC X code.

Example:

"11XEXAMPLE-BKV-A"

​
created_ts
string
required

ISO 8601 datetime when this clearing period was created.

Example:

"2026-02-01T00:00:00+00:00"

​
last_modified_ts
string
required

ISO 8601 datetime of the most recent modification.

Example:

"2026-02-25T10:00:00+00:00"

​
org_uid
string
required

Organization that owns this clearing period.

​
status
string
required

Clearing status: open, preliminary, objection, final, or closed.

Examples:

"open"

"preliminary"

"final"

​
uid
string
required

Unique identifier for this clearing period.

Example:

"c5d6e7f8-a9b0-4c1d-8e2f-3a4b5c6d7e8f"

​
final_deadline
string | null

Final billing deadline (M+42 WT) as ISO 8601 datetime.

Example:

"2026-03-31T23:59:59+02:00"

​
objection_deadline
string | null

Objection window closing deadline (M+30 WT) as ISO 8601 datetime.

Example:

"2026-03-13T23:59:59+01:00"

​
preliminary_deadline
string | null

Preliminary billing deadline (M+18 WT) as ISO 8601 datetime.

Example:

"2026-02-25T23:59:59+01:00"

​
total_imbalance_cost_eur
number | null

Total imbalance cost in EUR based on reBAP prices.

Example:

1875

​
total_imbalance_mwh
number | null

Total imbalance energy in MWh across all settlement days.

Example:

12.5