Skip to main content
POST
/
schedule-management
/
v1
/
mabis
/
clearing-periods
Create Clearing Period
curl --request POST \
  --url https://api.engrate.io/schedule-management/v1/mabis/clearing-periods \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bilanzierungsmonat": "2023-12-25",
  "bilanzkreis_eic": "<string>",
  "final_deadline": "2023-11-07T05:31:56Z",
  "objection_deadline": "2023-11-07T05:31:56Z",
  "preliminary_deadline": "2023-11-07T05:31:56Z"
}
'
{
  "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

Body

application/json

Request to create a clearing period.

​
bilanzierungsmonat
string<date>
required

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.

​
bilanzkreis_eic
string
required

Balance group (Bilanzkreis) EIC X code (16-character organization code, starts with '11X'). Registered with the TSO as the BRP identifier.

​
final_deadline
string<date-time> | null

Final billing deadline (ISO 8601 datetime). Corresponds to M+42 WT per BK6-24-174.

​
objection_deadline
string<date-time> | null

Objection window closing deadline (ISO 8601 datetime). Corresponds to M+30 WT — after this date objections can no longer be submitted.

​
preliminary_deadline
string<date-time> | null

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

Response

Successful Response

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