Zum Hauptinhalt springen
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"
}

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

"TenneT"

​
counterparty
object
erforderlich

The counterparty in a nomination (Otark acts as intermediary)

​
slots
object[]
erforderlich

Delivery time slots with volumes

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