Zum Hauptinhalt springen
GET
/
v1
/
customers
List customers
curl --request GET \
  --url https://api.otark.energy/v1/customers \
  --header 'X-Api-Key: <api-key>'
{
  "customers": [
    {
      "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"
    }
  ],
  "pagination": {
    "limit": 10,
    "has_more": true
  }
}

Autorisierungen

X-Api-Key
string
header
erforderlich

Abfrageparameter

status
enum<string>

Filter by customer status

Verfügbare Optionen:
pending,
approved,
rejected

Free-text search on name or metadata values

limit
integer
Standard:10

Maximum number of items per page

Erforderlicher Bereich: 1 <= x <= 100
after
string

Return records after this ID (cursor-based pagination)

Beispiel:

"con_a1b2c3d4"

Antwort

Customers list

customers
object[]
erforderlich

List of customers

pagination
object
erforderlich