Zum Hauptinhalt springen
GET
/
v1
/
customers
/
{customer_id}
Get customer
curl --request GET \
  --url https://api.otark.energy/v1/customers/{customer_id} \
  --header 'X-Api-Key: <api-key>'
{
  "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",
  "created_at": "2026-01-10T09:00:00Z",
  "activated_at": "2026-01-10T11:30:00Z"
}

Autorisierungen

​
X-Api-Key
string
header
erforderlich

Pfadparameter

​
customer_id
string
erforderlich

Customer identifier

Beispiel:

"cust_r8s9t0u1"

Antwort

Customer details

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,
active,
deactivated
Beispiel:

"active"

​
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"

​
activated_at
string<date-time> | null

ISO 8601 timestamp when the customer was activated

Beispiel:

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