Skip to main content
GET
/
v1
/
nominations
List nominations
curl --request GET \
  --url https://api.otark.energy/v1/nominations \
  --header 'X-Api-Key: <api-key>'
{
  "nominations": [
    {
      "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"
    }
  ],
  "pagination": {
    "limit": 10,
    "has_more": true
  }
}

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
status
enum<string>

Filter by nomination status

Available options:
pending,
partial_match,
match,
superseded
​
eic
string

Filter by customer EIC code

Example:

"11YWINDPARKNO--A"

​
delivery_date
string<date>

Filter by delivery date (shorthand for full-day range)

Example:

"2026-01-15"

​
delivery_start
string<date-time>

Filter: delivery start >= this value (ISO 8601)

Example:

"2026-01-01T00:00:00Z"

​
delivery_end
string<date-time>

Filter: delivery end <= this value (ISO 8601)

Example:

"2026-03-31T23:45:00Z"

​
slot_number_from
integer

Filter: slot number >= this value (1–100)

Required range: 1 <= x <= 100
​
slot_number_to
integer

Filter: slot number <= this value (1–100)

Required range: 1 <= x <= 100
​
include_slots
boolean
default:false

Include the slots array in the response (default false). When false, the slots field is omitted.

​
limit
integer
default:10

Maximum number of items per page

Required range: 1 <= x <= 100
​
after
string

Return records after this ID (cursor-based pagination)

Example:

"con_a1b2c3d4"

Response

Nominations list

​
nominations
object[]
required

List of nominations

​
pagination
object
required