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 '
{
  "bilanzkreis_eic": "<string>",
  "bilanzierungsmonat": "2023-12-25",
  "preliminary_deadline": "2023-11-07T05:31:56Z",
  "objection_deadline": "2023-11-07T05:31:56Z",
  "final_deadline": "2023-11-07T05:31:56Z"
}
'
{
  "uid": "<string>",
  "org_uid": "<string>",
  "bilanzkreis_eic": "<string>",
  "bilanzierungsmonat": "<string>",
  "status": "<string>",
  "created_ts": "<string>",
  "last_modified_ts": "<string>",
  "preliminary_deadline": "<string>",
  "objection_deadline": "<string>",
  "final_deadline": "<string>",
  "total_imbalance_mwh": 123,
  "total_imbalance_cost_eur": 123
}

Authorizations

​
Authorization
string
header
required

Body

application/json

Request to create a clearing period.

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

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

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

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

​
final_deadline
string<date-time> | null

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

Response

Successful Response

Response model for ClearingPeriod.

​
uid
string
required
​
org_uid
string
required
​
bilanzkreis_eic
string
required
​
bilanzierungsmonat
string
required
​
status
string
required
​
created_ts
string
required
​
last_modified_ts
string
required
​
preliminary_deadline
string | null
​
objection_deadline
string | null
​
final_deadline
string | null
​
total_imbalance_mwh
number | null
​
total_imbalance_cost_eur
number | null