BRP Connect APIKunden
Update customer
Update a customer's status, balance group, or metadata. Used to activate a pending customer, deactivate an existing one, change their balance group, or manage custom metadata. Metadata is merged on update — only provided keys are added or overwritten. Set a key's value to null to remove it. Required scope: customers:write
X-Api-Key<token>
In: header
Path Parameters
customer_idstring
Customer identifier
status?string
New customer status
Value in
"pending" | "active" | "deactivated"balance_group?BalanceGroup
A balance group assignment
metadata?object
Key-value pairs to merge into existing metadata
Empty Object
Response Body
curl -X PATCH "https://api.otark.energy/v1/customers/cust_r8s9t0u1" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "cust_r8s9t0u1",
"name": "SolarDach GmbH",
"status": "active",
"balance_group": {
"eic": "11YSOLARDACH--A",
"tso": "DE_AMPRION"
},
"metadata": {
"customer_number": "KD-2026-0815",
"cost_center": "CC-4200",
"region": "NRW"
},
"assigned_at": "2026-01-10T09:00:00Z",
"activated_at": "2026-01-10T11:30:00Z",
"created_at": "2026-01-10T09:00:00Z"
}{
"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"
}{
"type": "https://brp.otark.team/errors/already_active",
"title": "Customer Already Active",
"status": 409
}