Skip to main content
GET
/
schedule-management
/
v1
/
mabis
/
clearing-periods
List Clearing Periods
curl --request GET \
  --url https://api.engrate.io/schedule-management/v1/mabis/clearing-periods \
  --header 'Authorization: <api-key>'
[
  {
    "bilanzierungsmonat": "<string>",
    "bilanzkreis_eic": "<string>",
    "created_ts": "<string>",
    "last_modified_ts": "<string>",
    "org_uid": "<string>",
    "status": "<string>",
    "uid": "<string>",
    "final_deadline": "2026-03-31T23:59:59+02:00",
    "objection_deadline": "2026-03-13T23:59:59+01:00",
    "preliminary_deadline": "2026-02-25T23:59:59+01:00",
    "total_imbalance_cost_eur": 1875,
    "total_imbalance_mwh": 12.5
  }
]

Authorizations

​
Authorization
string
header
required

Query Parameters

​
status
string | null

Filter by clearing status: open, preliminary, objection, final, or closed.

​
bilanzkreis_eic
string | null

Filter by balance group EIC X code (16-character, starts with 11X).

Response

Successful Response

​
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