Zum Hauptinhalt springen
GET
Get nomination

Autorisierungen

X-Api-Key
string
header
erforderlich

Pfadparameter

nomination_id
string
erforderlich

Nomination identifier

Beispiel:

"nom_t4u5v6w7x8"

Antwort

Nomination details

The net saldo of valid transactions, aggregated by balance group and delivery period. Nominations are immutable — corrections produce a new version.

id
string
erforderlich

Unique nomination identifier

Beispiel:

"nom_t4u5v6w7x8"

status
enum<string>
erforderlich

Nomination status

Verfügbare Optionen:
pending,
partial_match,
match,
superseded
Beispiel:

"match"

version
integer
erforderlich

Version number (starts at 1, increments on correction)

Beispiel:

1

gate_closure
string<date-time> | null
erforderlich

ISO 8601 gate closure deadline

Beispiel:

"2026-01-14T14:30:00Z"

direction
enum<string>
erforderlich

Energy direction from the BRP's perspective

Verfügbare Optionen:
out,
in
Beispiel:

"out"

eic
string
erforderlich

EIC code (balance group) of the BRP

Beispiel:

"11YWINDPARKNO--A"

tso
enum<string>
erforderlich

BRP's TSO

Verfügbare Optionen:
DE_AMPRION,
DE_TENNET,
DE_TRANSNET_BW,
DE_50HERTZ
Beispiel:

"DE_TENNET"

counterparty
object
erforderlich

The counterparty in a nomination (Otark acts as intermediary)

created_at
string<date-time>
erforderlich

ISO 8601 creation timestamp

Beispiel:

"2026-01-14T14:30:00Z"

previous_nomination_id
string | null

ID of the nomination this version supersedes

Beispiel:

null

confirmed_at
string<date-time> | null

ISO 8601 timestamp when the nomination was confirmed

Beispiel:

"2026-01-14T15:00:00Z"

sent_at
string<date-time> | null

ISO 8601 timestamp when sent to the TSO

Beispiel:

"2026-01-14T14:35:00Z"

slots
object[]

Delivery time slots with volumes (only present when include_slots=true on list endpoint; always present on detail/bulk/history endpoints)