BRP Connect APITransaktionen
List contract transactions
List transactions under a specific contract. Same filters as the global transactions endpoint, minus contract_id and type. Required scopes: contracts:read, transactions:read
X-Api-Key<token>
In: header
Path Parameters
contract_idstring
Contract identifier
Query Parameters
status?string
Filter by transaction status
Value in
"valid" | "invalid" | "superseded"sender_eic?string
Filter by sender EIC code
receiver_eic?string
Filter by receiver EIC code
delivery_date?string
Filter by delivery date (shorthand for full-day range)
Format
datedelivery_start?string
Filter: delivery start >= this value (ISO 8601)
Format
date-timedelivery_end?string
Filter: delivery end <= this value (ISO 8601)
Format
date-timeslot_number_from?integer
Filter: slot number >= this value (1–100)
Range
1 <= value <= 100slot_number_to?integer
Filter: slot number <= this value (1–100)
Range
1 <= value <= 100include_assets?string
Include a deduplicated assets array in the response, containing all assets referenced by the returned transactions
Default
"false"Value in
"true" | "false"limit?integer
Maximum number of items per page
Default
10Range
1 <= value <= 100after?string
Cursor for the next page — pass the next_cursor value from the previous response
Response Body
curl -X GET "https://api.otark.energy/v1/contracts/con_a1b2c3d4/transactions?status=valid&sender_eic=11YWINDPARKNO--A&receiver_eic=11YGREENENERGY-Z&delivery_date=2026-01-15&delivery_start=2026-01-01T00%3A00%3A00Z&delivery_end=2026-03-31T23%3A45%3A00Z&slot_number_from=1&slot_number_to=1&include_assets=true&limit=10&after=con_a1b2c3d4"{
"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"
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "txn_k8m2p4q7r1"
},
"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."
}{
"type": "https://brp.otark.team/errors/customer_not_found",
"title": "Customer Not Found",
"status": 404,
"instance": "/v1/customers/cust_r8s9t0u1"
}