Skip to main content
GET
Get nomination

Authorizations

X-Api-Key
string
header
required

Path Parameters

nomination_id
string
required

Nomination identifier

Example:

"nom_t4u5v6w7x8"

Response

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
required

Unique nomination identifier

Example:

"nom_t4u5v6w7x8"

status
enum<string>
required

Nomination status

Available options:
pending,
partial_match,
match,
superseded
Example:

"match"

version
integer
required

Version number (starts at 1, increments on correction)

Example:

1

gate_closure
string<date-time> | null
required

ISO 8601 gate closure deadline

Example:

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

direction
enum<string>
required

Energy direction from the BRP's perspective

Available options:
out,
in
Example:

"out"

eic
string
required

EIC code (balance group) of the BRP

Example:

"11YWINDPARKNO--A"

tso
enum<string>
required

BRP's TSO

Available options:
DE_AMPRION,
DE_TENNET,
DE_TRANSNET_BW,
DE_50HERTZ
Example:

"DE_TENNET"

counterparty
object
required

The counterparty in a nomination (Otark acts as intermediary)

created_at
string<date-time>
required

ISO 8601 creation timestamp

Example:

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

previous_nomination_id
string | null

ID of the nomination this version supersedes

Example:

null

confirmed_at
string<date-time> | null

ISO 8601 timestamp when the nomination was confirmed

Example:

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

sent_at
string<date-time> | null

ISO 8601 timestamp when sent to the TSO

Example:

"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)