Skip to main content
POST
/
schedule-management
/
v1
/
send_status_request
Send Status Request
curl --request POST \
  --url https://api.engrate.io/schedule-management/v1/send_status_request \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2023-12-25",
  "sender_id": "<string>",
  "tso": "<string>"
}
'
{
  "message_id": "<string>",
  "status": "<string>",
  "error_message": "<string>",
  "next_allowed_at": "<string>",
  "sent_at": "2026-03-26T10:00:00+00:00"
}

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"