BRP Connect API

GET /v1/nominations/bulk

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

Als Markdown anzeigen
GET
/v1/nominations/bulk
X-Api-Key<token>

In: header

Query Parameters

idsstring

Kommagetrennte Liste von Nominierungskennungen (höchstens 100)

Response Body

curl -X GET "https://api.otark.energy/v1/nominations/bulk?ids=nom_t4u5v6w7x8%2Cnom_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."
}