Redispatching B2B API (1.0.0)

Download OpenAPI specification:

B2B API for TSO redispatching services.

Part 1 — Real-time SSE + REST for redispatching orders workflow

Client connects to /redispatch/{entityId}/stream.
Resumption: If the connection drops, the Client MUST reconnect providing the Last-Event-ID header with the ID of the last received event. The server will replay missed events.
Client listens for ORDER_ISSUED events and heartbeat signals.
When an ORDER_ISSUED event is received, Client fetches details via GET.
Client sends confirmation and decision via POST.

Part 2 — Batch REST settlement API Endpoints for submitting and querying redispatching data: DSO redispatches, grid constraints, certified energy volumes, auction support requests, balancing entity changes, and object configuration.

SSE Streaming

Server-Sent Events stream for real-time order notifications

Subscribe to order-issued events

Opens a Server-Sent Events (SSE) stream for a specific entity.

Resumption: To resume a broken connection without missing events, the client MUST provide the Last-Event-ID header containing the ID of the last event successfully processed. The server will replay events occurring after that ID.

Authorizations:

mTLS

path Parameters

entityId

required

string

Unique 5-character identifier of the entity.

header Parameters

Last-Event-ID

string

The ID of the last event the client received. If provided, the server will replay all subsequent events that occurred after this ID before sending new real-time events.

Responses

Response samples

200

Content type

text/event-stream

Example

Initial Connected Event

{
  "eventType": "connected",
  "connectionId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2025-07-22T08:00:00Z"
}

Subscribe to validation status events

Opens a Server-Sent Events (SSE) stream for a validation status notification events.

Resumption: To resume a broken connection without missing events, the client MUST provide the Last-Event-ID header containing the ID of the last event successfully processed. The server will replay events occurring after that ID.

Authorizations:

mTLS

header Parameters

Last-Event-ID

string

The ID of the last event the client received. If provided, the server will replay all subsequent events that occurred after this ID before sending new real-time events.

Responses

Response samples

200

Content type

text/event-stream

Example

Initial Connected Event

{
  "eventType": "connected",
  "connectionId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2025-07-22T08:00:00Z"
}

Redispatch Orders

Retrieve and acknowledge redispatching orders

Get redispatching order details

Fetches the full technical details of a specific redispatching order.

Authorizations:

mTLS

path Parameters

entityId required	string
redispatchOrderId required	string The business ID of the order (URL encoded).

Responses

Response samples

200

Content type

application/json

{"redispatchOrderId": "1/I/22.07.2025",
"entityId": "strin",
"issueOrderTs": "2019-08-24T14:15:22Z",
"isInformational": true,
"redispatchOrderReason": "B",
"redispatchOrderPeriod": {"startDt": "2019-08-24T14:15:22Z",
"endDt": "2019-08-24T14:15:22Z"
},
"redispatchOrders": [{"redispatchingObjectMrid": "9f25c3cb-b95b-4fbd-aa5b-082eeefd29de",
"measurementUnit": "MAW",
"curveType": "A01",
"seriesPeriods": [{"direction": "G",
"autogenerationRedispatch": "0",
"resolution": "P1D",
"timeInterval": {"startDt": "2019-08-24T14:15:22Z",
"endDt": "2019-08-24T14:15:22Z"
},
"seriesPoints": [{"position": 0,
"quantityMax": 0,
"quantityMin": 0
}
]
}
]
}
]
}

Send acknowledgement or decision

Used for three stages of feedback:

Confirm Receipt: Send status RECEIVED immediately after fetching the order.
Accept: Send status ACCEPTED if the order can be realized.
Reject: Send status REJECTED if the order cannot be realized.

Authorizations:

mTLS

path Parameters

entityId required	string
redispatchOrderId required	string

Request Body schema: application/json
required

redispatchOrderId required	string Reference to the order ID.
entityId required	string = 5 characters
status required	string Enum: "RECEIVED" "ACCEPTED" "REJECTED" Status: RECEIVED, ACCEPTED, REJECTED.
reason	string <= 512 characters Optional comment for the decision.

Responses

Request samples

Payload

Content type

application/json

{"redispatchOrderId": "string",
"entityId": "strin",
"status": "RECEIVED",
"reason": "string"
}

Retrieve redispatching orders for a given date

Returns the list of TSO redispatching orders issued for the specified delivery day.

Authorizations:

mTLS

query Parameters

redispatchDate

required

string <date>

Delivery day for which redispatching orders are requested.

Responses

Response samples

200
400
403
404

Content type

application/json

[{"mRID": "string",
"redispatchTable": [{"seriesPeriod": {"timeInterval": {"start": "2024-03-12T02:00:00Z",
"end": "2024-03-13T02:00:00Z"
},
"seriesIntervals": [{"end": "2024-03-13T02:00:00Z",
"pZad": 0,
"redispatchType": "B"
}
]
}
}
]
}
]

DSO Redispatch

Submit and query DSO redispatching redispatches

Submit DSO redispatches

Submits the list of redispatching orders issued by the DSO for a given delivery day.

Authorizations:

mTLS

Request Body schema: application/json

Array

mRID	string Unikalny identyfikator MWE
redispatchDate	string <date> Doba redysponowania wynikająca z polecenia wydanego przez OSP
	Array of objects (DsoRedispatchTable)

Responses

Request samples

Payload

Content type

application/json

[{"mRID": "",
"redispatchDate": "",
"redispatchTable": [{"redispatchingTimeBegin": "2019-08-24T14:15:22Z",
"redispatchingTimeEnd": "2019-08-24T14:15:22Z",
"pZad": 0,
"redispatchType": "B"
}
]
}
]

Response samples

200
400

Content type

application/json

{"requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}

Get DSO redispatching processing status

Retrieves the processing status of previously submitted DSO redispatches.

Authorizations:

mTLS

query Parameters

requestId

required

string

Identifier of the submitted data.

Responses

Response samples

200

Content type

application/json

{"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "APPROVED",
"validationViolations": [{"severity": "WARN",
"code": "string",
"field": "string",
"message": "string"
}
]
}

Grid Constraints

Submit and query DSO grid constraints unrelated to TSO orders

Submit DSO grid constraints

Submits DSO grid constraints unrelated to a TSO-issued redispatching order.

Authorizations:

mTLS

Request Body schema: application/json

Array

mRID	string Unique generation unit (MWE) identifier.
constraintDate	string <date> Grid coinstraint day.
	Array of objects

Responses

Request samples

Payload

Content type

application/json

[{"mRID": "string",
"constraintDate": "2019-08-24",
"constraintTable": [{"constraintTimeBegin": "2019-08-24T14:15:22Z",
"constraintTimeEnd": "2019-08-24T14:15:22Z",
"pZadDso": 0
}
]
}
]

Response samples

200
400

Content type

application/json

{"requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}

Get grid constraints processing status

Retrieves the processing status of previously submitted DSO grid constraints.

Authorizations:

mTLS

query Parameters

requestId

required

string

Identifier of the submitted data.

Responses

Response samples

200

Content type

application/json

{"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "APPROVED",
"validationViolations": [{"severity": "WARN",
"code": "string",
"field": "string",
"message": "string"
}
]
}

Certified Energy

Submit and query certified generated energy volumes (E_WYK_CERT)

Submit certified generated energy volumes

Submits certified generated energy (E_WYK_CERT) volumes measured at generator terminals.

Authorizations:

mTLS

Request Body schema: application/json

Array

mRID	string Unique generation unit (MWE) identifier.
redispatchDate	string <date> Redispatch delivery day as determined by the TSO order.
	Array of objects

Responses

Request samples

Payload

Content type

application/json

[{"mRID": "string",
"redispatchDate": "2019-08-24",
"seriesPeriods": [{"timeInterval": {"start": "2024-03-12T02:00:00Z",
"end": "2024-03-13T02:00:00Z"
},
"resolution": "PT15M",
"seriesPoints": [{"position": 0,
"eWykCert": 0
}
]
}
]
}
]

Response samples

200
400

Content type

application/json

{"requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}

Get certified energy processing status

Retrieves the processing status of previously submitted E_WYK_CERT values.

Authorizations:

mTLS

query Parameters

requestId

required

string

Identifier of the submitted data.

Responses

Response samples

200

Content type

application/json

{"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "APPROVED",
"validationViolations": [{"severity": "WARN",
"code": "string",
"field": "string",
"message": "string"
}
]
}

Auction Support

Submit and query auction support requests (uOZE)

Retrieve auction support requests

Returns auction support requests (uOZE) forwarded to the DSO via the WOZE system for the given delivery day.

Authorizations:

mTLS

query Parameters

redispatchDate

required

string <date>

Delivery day for which auction support requests are retrieved.

Responses

Response samples

200

Content type

application/json

[{"mRID": "string",
"redispatchDate": "2019-08-24",
"notificationDate": "2019-08-24",
"energy": 0
}
]

Submit auction support requests

Submits auction support requests (uOZE) forwarded to the DSO outside of the WOZE system.

Authorizations:

mTLS

Request Body schema: application/json

Array

mRID	string Unique generation unit (MWE) identifier.
redispatchDate	string <date> Redispatch delivery day as determined by the TSO order.
notificationDate	string <date> Date when the DSO was notified about whether and what portion of reduced energy should be settled under the given support system.
energy	integer <int32> Percentage of reduced energy that should be settled under the given support system (per Art. 93(18) of the Renewable Energy Sources Act).

Responses

Request samples

Payload

Content type

application/json

[{"mRID": "string",
"redispatchDate": "2019-08-24",
"notificationDate": "2019-08-24",
"energy": 0
}
]

Response samples

200
400

Content type

application/json

{"requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}

Get auction support request processing status

Retrieves the processing status of previously submitted auction support requests (uOZE).

Authorizations:

mTLS

query Parameters

requestId

required

string

Identifier of the submitted data.

Responses

Response samples

200

Content type

application/json

{"requestId": "550e8400-e29b-41d4-a716-446655440000",
"status": "APPROVED",
"validationViolations": [{"severity": "WARN",
"code": "string",
"field": "string",
"message": "string"
}
]
}

Configuration

Retrieve redispatching object configuration

Get redispatching object configuration

Retrieves the configuration of redispatching objects for the specified entity and date.

The type parameter controls the level of detail:

0 — list all redispatching objects for the given DSO
1 — list all redispatching objects with their constituent resources
2 — list resources for a specific redispatching object (use objects query parameter to filter)

Authorizations:

mTLS

path Parameters

entityId required	string Entity identifier.
type required	string Enum: "0" "1" "2" Query type. 0 — all objects, 1 — objects with resources, 2 — resources of specified objects.
date required	string <date> Configuration date. The response returns the object configuration as of this date.

query Parameters

objects

Array of strings <uuid> [ items <uuid > ]

List of redispatching object mRIDs to filter (used with type=2).

Responses

Response samples

200

Content type

application/json

{"type": "0",
"date": "2023-09-24",
"objects": [{"redispatchingObjectMrid": "9f25c3cb-b95b-4fbd-aa5b-082eeefd29de",
"redispatchingObjectCode": "KA-10106-19027-03/P/PV/PD/G1/WN/BZ/BI/",
"objectResources": [{"registeredResourceMrid": "d0443a92-f807-45f0-867e-70cf5321dec7",
"registeredResourceCode": "stringstringstringstringstringstring",
"registeredResourcePRef": 99999.999
}
]
}
]
}

Redispatching B2B API (1.0.0)

SSE Streaming

Subscribe to order-issued events

Authorizations:

path Parameters

header Parameters

Responses

Response samples

Subscribe to validation status events

Authorizations:

header Parameters

Responses

Response samples

Redispatch Orders

Get redispatching order details

Authorizations:

path Parameters

Responses

Response samples

Send acknowledgement or decision

Authorizations:

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Retrieve redispatching orders for a given date

Authorizations:

query Parameters

Responses

Response samples

DSO Redispatch

Submit DSO redispatches

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Get DSO redispatching processing status

Authorizations:

query Parameters

Responses

Response samples

Grid Constraints

Submit DSO grid constraints

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Get grid constraints processing status

Authorizations:

query Parameters

Responses

Response samples

Certified Energy

Submit certified generated energy volumes

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Get certified energy processing status

Authorizations:

query Parameters

Responses

Response samples

Auction Support

Retrieve auction support requests

Authorizations:

query Parameters

Responses

Response samples

Submit auction support requests

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Get auction support request processing status

Authorizations:

Request Body schema: application/json
required