GET /v1/transactions/bulk
Mehrere Transaktionen ü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: transactions:read
In: header
Query Parameters
Kommagetrennte Liste von Transaktionskennungen (höchstens 100)
Ein bereinigtes Feld assets in die Antwort aufnehmen, das alle von den gelieferten Transaktionen referenzierten Anlagen enthält
"false""true" | "false"Response Body
curl -X GET "https://api.otark.energy/v1/transactions/bulk?ids=txn_k8m2p4q7r1%2Ctxn_j5n3w8v2x6%2Ctxn_h2b7f9d4g3&include_assets=true"{
"transactions": [
{
"id": "txn_k8m2p4q7r1",
"type": "ppa",
"contract_id": "con_a1b2c3d4",
"status": "valid",
"version": 2,
"previous_transaction_id": "txn_j5n3w8v2x6",
"sender": {
"eic": "11YDIREKTVERM--A",
"asset_id": "ast_w1x2y3z4",
"tso": "DE_TENNET"
},
"receiver": {
"eic": "11YSTADTWERKE--Z",
"tso": "DE_TENNET"
},
"delivery_start": "2026-07-15T11:00:00Z",
"delivery_end": "2026-07-15T11:15:00Z",
"slot_number": 53,
"volume": 1.563,
"created_at": "2026-07-14T10:30:00Z"
}
],
"assets": [
{
"id": "ast_w1x2y3z4",
"name": "Solar Park SP-1",
"nominal_power": 10,
"technology": "solar",
"tso": "DE_TENNET"
}
]
}{
"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."
}/transactions/{transaction_id}/history GET
Den vollständigen Versionsverlauf einer Transaktion abrufen, entlang der Kette previous_transaction_id. Liefert alle Versionen, von der neuesten zur ältesten sortiert. Erforderlicher Scope: transactions:read
/transactions/bulk POST
Mehrere Transaktionen ü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: transactions:read