Skip to main content
GET
/
v1
/
nominations
/
{nomination_id}
Get nomination
curl --request GET \
  --url https://api.otark.energy/v1/nominations/{nomination_id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "nom_t4u5v6w7x8",
  "status": "match",
  "version": 1,
  "gate_closure": "2026-01-14T14:30:00Z",
  "direction": "out",
  "eic": "11YWINDPARKNO--A",
  "tso": "TenneT",
  "counterparty": {
    "name": "Otark",
    "eic": "11YOTARK------Z"
  },
  "slots": [
    {
      "delivery_start": "2026-01-15T14:00:00Z",
      "delivery_end": "2026-01-15T14:15:00Z",
      "slot_number": 57,
      "amount": 12.5,
      "matched_amount": 12.5
    }
  ],
  "created_at": "2026-01-14T14:30:00Z",
  "previous_nomination_id": null,
  "confirmed_at": "2026-01-14T15:00:00Z",
  "sent_at": "2026-01-14T14:35:00Z"
}

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>
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:
Amprion,
TenneT,
TransnetBW,
50 Hertz
Example:

"TenneT"

​
counterparty
object
required

The counterparty in a nomination (Otark acts as intermediary)

​
slots
object[]
required

Delivery time slots with volumes

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