POST /v1/nominations/bulk
Mehrere Nominierungen über ihre Kennungen im Anfrage-Body abrufen. Dieser Weg ist für große Kennungsmengen gedacht, die über das Limit des GET-Query-Parameters hinausgehen. Kennungen, die nicht existieren oder nicht zugänglich sind, werden stillschweigend übergangen. Erforderlicher Scope: nominations:read
In: header
Liste der abzurufenden Nominierungskennungen (höchstens 100)
1 <= items <= 100Response Body
curl -X POST "https://api.otark.energy/v1/nominations/bulk" \ -H "Content-Type: application/json" \ -d '{ "ids": [ "nom_t4u5v6w7x8", "nom_q1r2s3t4u5" ] }'{
"nominations": [
{
"id": "nom_t4u5v6w7x8",
"status": "match",
"version": 2,
"previous_nomination_id": "nom_s3t4u5v6w7",
"gate_closure": "2026-07-14T12:30:00Z",
"confirmed_at": "2026-07-14T12:45:00Z",
"direction": "out",
"eic": "11YDIREKTVERM--A",
"tso": "DE_TENNET",
"sent_at": "2026-07-14T12:20:00Z",
"counterparty": {
"name": "OTARK-CLEARING",
"eic": "11Y0-0000-3333-F"
},
"slots": [
{
"delivery_start": "2026-07-15T11:00:00Z",
"delivery_end": "2026-07-15T11:15:00Z",
"slot_number": 53,
"amount": 1.563,
"matched_amount": 1.563
}
],
"created_at": "2026-07-14T10:30:00Z"
}
]
}{
"type": "https://brp.otark.energy/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/customers/cust_r8s9t0u1",
"errors": [
{
"field": "balance_group.tso",
"code": "invalid_enum_value",
"message": "Invalid enum value. Expected 'DE_AMPRION' | 'DE_TENNET' | 'DE_TRANSNET_BW' | 'DE_50HERTZ', received 'INVALID'"
}
]
}{
"type": "https://brp.otark.energy/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://brp.otark.energy/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: customers:write. Please create a new API key with the required scopes."
}/nominations/bulk GET
Mehrere Nominierungen über ihre Kennungen in einer einzigen Anfrage abrufen. Über den Query-Parameter sind höchstens 100 Kennungen möglich. Kennungen, die nicht existieren oder nicht zugänglich sind, werden stillschweigend übergangen. Erforderlicher Scope: nominations:read
/customers GET
Die Kunden auflisten, die dem angemeldeten BKV zugeordnet sind. Erforderlicher Scope: customers:read