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 starting with '11X' or '10X') as registered with the TSO.

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:

"SR-20260326-001"

status
string
required

Submission result: sent, rate_limited, or error.

Examples:

"sent"

"rate_limited"

error_message
string | null

Error description if the request failed.

next_allowed_at
string | null

ISO 8601 datetime when the next request is allowed (present when rate-limited).

sent_at
string | null

ISO 8601 datetime when the request was sent, if successful.

Example:

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