Zum Hauptinhalt springen
PATCH
/
v1
/
customers
/
{customer_id}
Update customer
curl --request PATCH \
  --url https://api.otark.energy/v1/customers/{customer_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "status": "approved",
  "metadata": {
    "customer_number": "KD-2026-0815",
    "cost_center": "CC-4200"
  }
}
'
{
  "id": "cust_r8s9t0u1",
  "name": "SolarDach GmbH",
  "status": "approved",
  "balance_group": {
    "eic": "11YSOLARDACH--A",
    "tso": "Amprion"
  },
  "metadata": {
    "customer_number": "KD-2026-0815",
    "cost_center": "CC-4200",
    "region": "NRW"
  },
  "assigned_at": "2026-01-10T09:00:00Z",
  "created_at": "2026-01-10T09:00:00Z",
  "updated_at": "2026-01-10T11:30:00Z",
  "approved_at": "2026-01-10T11:30:00Z"
}

Autorisierungen

​
X-Api-Key
string
header
erforderlich

Pfadparameter

​
customer_id
string
erforderlich

Customer identifier

Beispiel:

"cust_r8s9t0u1"

Body

application/json

Partial update for a customer. Metadata is merged — only provided keys are added or overwritten. Set a key to null to remove it.

​
status
enum<string>

New customer status

Verfügbare Optionen:
approved,
rejected
​
balance_group
object

A balance group assignment

​
metadata
object

Key-value pairs to merge into existing metadata

Beispiel:
{
  "customer_number": "KD-2026-0815",
  "cost_center": "CC-4200"
}

Antwort

Updated customer

A customer assigned to the BRP

​
id
string
erforderlich

Unique customer identifier

Beispiel:

"cust_r8s9t0u1"

​
name
string
erforderlich

Customer display name

Beispiel:

"SolarDach GmbH"

​
status
enum<string>
erforderlich

Customer status

Verfügbare Optionen:
pending,
approved,
rejected
Beispiel:

"approved"

​
balance_group
object
erforderlich

A balance group assignment

​
metadata
object
erforderlich

BRP-defined key-value pairs (free-form)

Beispiel:
{
  "customer_number": "KD-2026-0815",
  "cost_center": "CC-4200",
  "region": "NRW"
}
​
assigned_at
string<date-time>
erforderlich

ISO 8601 timestamp when the customer was assigned

Beispiel:

"2026-01-10T09:00:00Z"

​
created_at
string<date-time>
erforderlich

ISO 8601 creation timestamp

Beispiel:

"2026-01-10T09:00:00Z"

​
updated_at
string<date-time>
erforderlich

ISO 8601 last-modified timestamp

Beispiel:

"2026-01-10T11:30:00Z"

​
approved_at
string<date-time> | null

ISO 8601 timestamp when approved

Beispiel:

"2026-01-10T11:30:00Z"