BRP Connect APIContracts
Get contract
Retrieve a single contract by ID. Required scope: contracts:read
curl -X GET "https://api.otark.energy/v1/contracts/con_a1b2c3d4"{
"id": "con_a1b2c3d4",
"external_id": "PPA-2025-0042",
"type": "ppa",
"status": "in_progress",
"delivery_start": "2026-01-01T00:00:00Z",
"delivery_end": "2026-03-31T23:45:00Z",
"seller": {
"name": "GreenCo Energy BV",
"eic": "11YGREENENERGY-Z",
"tso": "DE_TENNET"
},
"buyer": {
"name": "GreenCo Energy BV",
"eic": "11YGREENENERGY-Z",
"tso": "DE_TENNET"
},
"ppa_type": "indexed",
"period": "Q1-2026",
"delivery_profile": "ENWEX Solar 2026",
"asset": {
"id": "ast_w1x2y3z4",
"name": "Zonnepark De Wilgen",
"nominal_power": 25,
"technology": "solar",
"tso": "DE_TENNET"
},
"created_at": "2024-11-20T10:00:00Z"
}{
"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"
}List contracts GET
List contracts accessible to the authenticated BRP. Supports filtering by status, type, EIC code, delivery period, and active date. Required scope: contracts:read
List all transactions GET
List all transactions across contracts. Accepts the same filters as the contract-scoped endpoint, plus contract_id and type filters. Required scope: transactions:read