BRP Connect APINominierungen
Get nomination history
Retrieve the full version history of a nomination, following the previous_nomination_id chain. Returns all versions ordered from newest to oldest. Required scope: nominations:read
curl -X GET "https://api.otark.energy/v1/nominations/nom_t4u5v6w7x8/history"{
"nominations": [
{
"id": "nom_t4u5v6w7x8",
"status": "match",
"version": 1,
"previous_nomination_id": null,
"gate_closure": "2026-01-14T14:30:00Z",
"confirmed_at": "2026-01-14T15:00:00Z",
"direction": "out",
"eic": "11YWINDPARKNO--A",
"tso": "DE_TENNET",
"sent_at": "2026-01-14T14:35:00Z",
"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"
}
]
}{
"type": "https://brp.otark.team/errors/invalid_api_key",
"title": "Invalid API Key",
"status": 401
}{
"type": "https://brp.otark.team/errors/insufficient_scopes",
"title": "Insufficient API Key Scopes",
"status": 403,
"detail": "Missing scope: customers:write. Please create a new API key with the required scopes."
}{
"type": "https://brp.otark.team/errors/customer_not_found",
"title": "Customer Not Found",
"status": 404,
"instance": "/v1/customers/cust_r8s9t0u1"
}Get nomination GET
Retrieve a single nomination with its counterparties and slots. Required scope: nominations:read
Bulk get nominations GET
Retrieve multiple nominations by ID in a single request. Limited to 100 IDs via query parameter. Non-existent or inaccessible IDs are silently omitted. Required scope: nominations:read