Jetzt startenPPA Marketplace1-Click PPAGreen SPOTGranulare ZertifikateAbwicklungEntwicklerressourcenHilfe & Support
Support kontaktieren
BRP Connect APITransaktionen

Bulk get transactions (POST)

Retrieve multiple transactions by ID using a request body. Use this for large ID sets that exceed the GET query parameter limit. Non-existent or inaccessible IDs are silently omitted. Required scope: transactions:read

POST
/v1/transactions/bulk

Authorization

X-Api-Key<token>

In: header

Request Body

idsarray<string>

List of transaction IDs to retrieve (max 100)

Items1 <= items <= 100
include_assets?boolean

Include a deduplicated assets array in the response

Defaultfalse

Response Body

curl -X POST "https://api.otark.energy/v1/transactions/bulk" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "txn_k8m2p4q7r1",      "txn_j5n3w8v2x6",      "txn_h2b7f9d4g3"    ]  }'
{
  "transactions": [
    {
      "id": "txn_k8m2p4q7r1",
      "type": "ppa",
      "contract_id": "con_a1b2c3d4",
      "status": "valid",
      "version": 2,
      "previous_transaction_id": "txn_j5n3w8v2x6",
      "sender": {
        "eic": "11YWINDPARKNO--A",
        "asset_id": "ast_w1x2y3z4",
        "tso": "DE_TENNET"
      },
      "receiver": {
        "eic": "11YGREENENERGY-Z",
        "tso": "DE_TENNET"
      },
      "delivery_start": "2026-01-15T14:00:00Z",
      "delivery_end": "2026-01-15T14:15:00Z",
      "slot_number": 57,
      "volume": 12.5,
      "created_at": "2026-01-14T18:00:00Z"
    }
  ],
  "assets": [
    {
      "id": "ast_w1x2y3z4",
      "name": "Zonnepark De Wilgen",
      "nominal_power": 25,
      "technology": "solar",
      "tso": "DE_TENNET"
    }
  ]
}

{
  "type": "https://brp.otark.team/errors/validation",
  "title": "Validation Failed",
  "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.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."
}

Bulk get transactions GET

Retrieve multiple transactions by ID in a single request. Limited to 100 IDs via query parameter. Non-existent or inaccessible IDs are silently omitted. Required scope: transactions:read

List nominations GET

List nominations accessible to the authenticated BRP. Required scope: nominations:read