Skip to main content
POST
Send Status Request

Authorizations

Authorization
string
header
required

Body

application/json

Request body for sending a status request to TSO.

date
string<date>
required

Delivery date (YYYY-MM-DD). Example: '2026-01-24'.

sender_id
string
required

Your own EIC X code (balance responsible party, 16-character organization code) as registered with the TSO. Must match the EIC configured for the calling organization.

tso
string
required

TSO identifier. DE values: '50HERTZ_DE_TSO' (50Hertz), 'DE-AMPRION-TSO' (Amprion), 'TTG_DE' (TenneT DE), 'DE-TRANSNETBWTSO' (TransnetBW).

Minimum string length: 1

Response

Successful Response

Response from a status request submission to a TSO.

message_id
string
required

Message identifier assigned to the status request.

Example:

"SRQ-20260326-100000-A1B2C3D4"

status
string
required

Submission lifecycle state. An older version of this endpoint returned other status codes as well, but the only status returned now is queued; the field is retained for backwards compatibility.

Allowed value: "queued"
error_message
string | null

Always null. An older version of this endpoint used this for messaging failures; the field is kept for backwards compatibility.

next_allowed_at
string | null

Always null. An older version of this endpoint had rate limits here, but those are maintained internally now.

sent_at
string | null

ISO 8601 datetime when the message was queued.

Example:

"2026-03-26T10:00:00+00:00"