Geräte

9 endpoints

The endpoint descriptions come directly from the API and are in German.

Geräte auflisten

get/v1/devices

Ladepunkte mit aktuellem Zustand, Tarif, Abrechnungsmodell und QR-Code-URL.

Parameters

Name	In	Type
`location_id`optional	Query	string
`kind`optional	Query	string

Response 200DeviceList

Name	Type	Description
`object`required	"list"
`data`required	Device[]
`has_more`required	boolean

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X GET https://api.ladehase.com/v1/devices \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "object": "list",
  "data": [
    {
      "id": "dev_7d3a9c1b0e2f4a6b",
      "object": "device",
      "kind": "string",
      "livemode": true,
      "name": "Ladepunkt Scheune",
      "location_id": "string",
      "integration_id": "string",
      "manufacturer": "string",
      "model": "string",
      "serial_number": "string",
      "max_power_w": 0,
      "tariff_id": "string",
      "billing": {},
      "enabled": true,
      "locked": true,
      "prepared": true,
      "status": "string",
      "state": {
        "online": true,
        "status": "string",
        "cable_plugged": true,
        "power_w": 0,
        "meter_wh": 0,
        "authorization_required": true,
        "last_seen_at": "2026-10-25T08:30:00.000Z",
        "error": "string"
      },
      "active_session_id": "string",
      "connectors": [
        {
          "id": "string",
          "code": "string",
          "url": "string"
        }
      ],
      "created_at": "string"
    }
  ],
  "has_more": true
}

Gerät abrufen

get/v1/devices/{id}

Ein Gerät mit Zustand.

Parameters

Name	In	Type
`id`required	Path	string

Response 200Device

Name	Type	Description
`id`required	string	ID mit Präfix «dev_»
`object`required	"device"
`kind`required	string	Geräteart, vorerst «ev_charger»
`livemode`required	boolean
`name`required	string
`location_id`required	string
`integration_id`required	string \| null
`manufacturer`required	string \| null
`model`required	string \| null
`serial_number`required	string \| null
`max_power_w`required	integer \| null
`tariff_id`required	string \| null
`billing`required	object	Abrechnungsmodell, Reservationsgrenzen, Pakete
`enabled`required	boolean	Von Ladehase verwaltet und für Fahrende freigegeben
`locked`required	boolean	Vorübergehend gesperrt (keine neuen Ladungen)
`prepared`required	boolean	«Autorisierung erforderlich» beim Hersteller gesetzt
`status`required	string	Zusammengefasster Status für Anzeigen
`state`required	DeviceState
`active_session_id`required	string \| null
`connectors`required	object[]
`created_at`required	string

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X GET https://api.ladehase.com/v1/devices/{id} \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "id": "dev_7d3a9c1b0e2f4a6b",
  "object": "device",
  "kind": "string",
  "livemode": true,
  "name": "Ladepunkt Scheune",
  "location_id": "string",
  "integration_id": "string",
  "manufacturer": "string",
  "model": "string",
  "serial_number": "string",
  "max_power_w": 0,
  "tariff_id": "string",
  "billing": {},
  "enabled": true,
  "locked": true,
  "prepared": true,
  "status": "string",
  "state": {
    "online": true,
    "status": "string",
    "cable_plugged": true,
    "power_w": 0,
    "meter_wh": 0,
    "authorization_required": true,
    "last_seen_at": "2026-10-25T08:30:00.000Z",
    "error": "string"
  },
  "active_session_id": "string",
  "connectors": [
    {
      "id": "string",
      "code": "string",
      "url": "string"
    }
  ],
  "created_at": "string"
}

Gerät ändern

patch/v1/devices/{id}

Name, Standort, Tarif, Abrechnungsmodell (reservation, prepaid, both), Reservationsgrenzen, Pakete. `enabled: true` aktiviert das Gerät und setzt beim Hersteller «Autorisierung erforderlich».

Parameters

Name	In	Type
`id`required	Path	string

Request

Name	Type	Description
`name`optional	string
`location_id`optional	string
`tariff_id`optional	string \| null
`billing`optional	object
`enabled`optional	boolean

Response 200Device

Name	Type	Description
`id`required	string	ID mit Präfix «dev_»
`object`required	"device"
`kind`required	string	Geräteart, vorerst «ev_charger»
`livemode`required	boolean
`name`required	string
`location_id`required	string
`integration_id`required	string \| null
`manufacturer`required	string \| null
`model`required	string \| null
`serial_number`required	string \| null
`max_power_w`required	integer \| null
`tariff_id`required	string \| null
`billing`required	object	Abrechnungsmodell, Reservationsgrenzen, Pakete
`enabled`required	boolean	Von Ladehase verwaltet und für Fahrende freigegeben
`locked`required	boolean	Vorübergehend gesperrt (keine neuen Ladungen)
`prepared`required	boolean	«Autorisierung erforderlich» beim Hersteller gesetzt
`status`required	string	Zusammengefasster Status für Anzeigen
`state`required	DeviceState
`active_session_id`required	string \| null
`connectors`required	object[]
`created_at`required	string

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X PATCH https://api.ladehase.com/v1/devices/{id} \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"name":"string","location_id":"string","tariff_id":"string","billing":{"model":"reservation","reservationDefault":3000,"reservationMin":1000,"reservationMax":10000,"safetyMarginBps":300,"packages":[],"prepaidRemainder":"refund","plugTimeoutMinutes":10,"maxDurationMinutes":1440},"enabled":true}'

Response 200

{
  "id": "dev_7d3a9c1b0e2f4a6b",
  "object": "device",
  "kind": "string",
  "livemode": true,
  "name": "Ladepunkt Scheune",
  "location_id": "string",
  "integration_id": "string",
  "manufacturer": "string",
  "model": "string",
  "serial_number": "string",
  "max_power_w": 0,
  "tariff_id": "string",
  "billing": {},
  "enabled": true,
  "locked": true,
  "prepared": true,
  "status": "string",
  "state": {
    "online": true,
    "status": "string",
    "cable_plugged": true,
    "power_w": 0,
    "meter_wh": 0,
    "authorization_required": true,
    "last_seen_at": "2026-10-25T08:30:00.000Z",
    "error": "string"
  },
  "active_session_id": "string",
  "connectors": [
    {
      "id": "string",
      "code": "string",
      "url": "string"
    }
  ],
  "created_at": "string"
}

Zustand abfragen

get/v1/devices/{id}/state

Aktueller Zustand. Mit `refresh=true` wird beim Hersteller nachgefragt.

Parameters

Name	In	Type
`id`required	Path	string
`refresh`optional	Query	boolean \| null

Response 200DeviceState

Name	Type	Description
`online`optional	boolean
`status`optional	string	offline, available, vehicle_connected, awaiting_authorization, charging, suspended, finished, error
`cable_plugged`optional	boolean
`power_w`optional	integer	Aktuelle Leistung in Watt
`meter_wh`optional	integer \| null	Zählerstand in Wh
`authorization_required`optional	boolean \| null
`last_seen_at`optional	string \| null	Zeitpunkt (ISO 8601, UTC)
`error`optional	string \| null

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X GET https://api.ladehase.com/v1/devices/{id}/state \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "online": true,
  "status": "string",
  "cable_plugged": true,
  "power_w": 0,
  "meter_wh": 0,
  "authorization_required": true,
  "last_seen_at": "2026-10-25T08:30:00.000Z",
  "error": "string"
}

Ladung ohne Zahlung starten

post/v1/devices/{id}/start

Gibt den Ladepunkt ohne Zahlung frei (z. B. eigenes Auto). Ladehase legt dafür eine Gratis-Sitzung an, damit die Energie erfasst wird.

Parameters

Name	In	Type
`id`required	Path	string
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Response 201Session

Name	Type	Description
`id`required	string	ID mit Präfix «ses_»
`object`required	"session"
`livemode`required	boolean
`state`required	string	Zustand gemäss Zustandsautomat (created … settled)
`mode`required	"reservation" \| "prepaid" \| "access"
`channel`required	"qr" \| "terminal" \| "api" \| "rfid" \| "access_link"
`location_id`required	string
`device_id`required	string
`connector_id`required	string
`currency`required	string
`authorized_amount`required	integer	Reservierter beziehungsweise bezahlter Betrag in Rappen
`amount`required	integer	Hochgerechneter Betrag (laufend) oder Endbetrag in Rappen
`captured_amount`required	integer	Belasteter Betrag in Rappen
`refunded_amount`required	integer	Zurückerstatteter Betrag in Rappen
`vat_amount`required	integer	MWST-Anteil in Rappen
`energy_wh`required	integer	Geladene Energie in Wh
`idle_minutes`required	integer
`stop_reason`required	string \| null
`receipt_number`required	string \| null
`started_at`required	string \| null	Zeitpunkt (ISO 8601, UTC)
`ended_at`required	string \| null	Zeitpunkt (ISO 8601, UTC)
`settled_at`required	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`required	string

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X POST https://api.ladehase.com/v1/devices/{id}/start \n  -H "Authorization: Bearer lh_test_…"

Response 201

{
  "id": "ses_1a2b3c4d5e6f7a8b9c0d",
  "object": "session",
  "livemode": true,
  "state": "string",
  "mode": "reservation",
  "channel": "qr",
  "location_id": "string",
  "device_id": "string",
  "connector_id": "string",
  "currency": "string",
  "authorized_amount": 1235,
  "amount": 1235,
  "captured_amount": 1235,
  "refunded_amount": 1235,
  "vat_amount": 1235,
  "energy_wh": 0,
  "idle_minutes": 0,
  "stop_reason": "string",
  "receipt_number": "string",
  "started_at": "2026-10-25T08:30:00.000Z",
  "ended_at": "2026-10-25T08:30:00.000Z",
  "settled_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Ladung am Gerät stoppen

post/v1/devices/{id}/stop

Stoppt die laufende Sitzung des Geräts und rechnet ab. Ohne Sitzung wird nur der Stoppbefehl gesendet.

Parameters

Name	In	Type
`id`required	Path	string
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Response 200Object

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X POST https://api.ladehase.com/v1/devices/{id}/stop \n  -H "Authorization: Bearer lh_test_…"

Response 200

{}

Gerät sperren

post/v1/devices/{id}/lock

Keine neuen Ladungen, laufende Ladung läuft weiter.

Parameters

Name	In	Type
`id`required	Path	string
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Response 200Device

Name	Type	Description
`id`required	string	ID mit Präfix «dev_»
`object`required	"device"
`kind`required	string	Geräteart, vorerst «ev_charger»
`livemode`required	boolean
`name`required	string
`location_id`required	string
`integration_id`required	string \| null
`manufacturer`required	string \| null
`model`required	string \| null
`serial_number`required	string \| null
`max_power_w`required	integer \| null
`tariff_id`required	string \| null
`billing`required	object	Abrechnungsmodell, Reservationsgrenzen, Pakete
`enabled`required	boolean	Von Ladehase verwaltet und für Fahrende freigegeben
`locked`required	boolean	Vorübergehend gesperrt (keine neuen Ladungen)
`prepared`required	boolean	«Autorisierung erforderlich» beim Hersteller gesetzt
`status`required	string	Zusammengefasster Status für Anzeigen
`state`required	DeviceState
`active_session_id`required	string \| null
`connectors`required	object[]
`created_at`required	string

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X POST https://api.ladehase.com/v1/devices/{id}/lock \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "id": "dev_7d3a9c1b0e2f4a6b",
  "object": "device",
  "kind": "string",
  "livemode": true,
  "name": "Ladepunkt Scheune",
  "location_id": "string",
  "integration_id": "string",
  "manufacturer": "string",
  "model": "string",
  "serial_number": "string",
  "max_power_w": 0,
  "tariff_id": "string",
  "billing": {},
  "enabled": true,
  "locked": true,
  "prepared": true,
  "status": "string",
  "state": {
    "online": true,
    "status": "string",
    "cable_plugged": true,
    "power_w": 0,
    "meter_wh": 0,
    "authorization_required": true,
    "last_seen_at": "2026-10-25T08:30:00.000Z",
    "error": "string"
  },
  "active_session_id": "string",
  "connectors": [
    {
      "id": "string",
      "code": "string",
      "url": "string"
    }
  ],
  "created_at": "string"
}

Gerät entsperren

post/v1/devices/{id}/unlock

Hebt die Sperre auf.

Parameters

Name	In	Type
`id`required	Path	string
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Response 200Device

Name	Type	Description
`id`required	string	ID mit Präfix «dev_»
`object`required	"device"
`kind`required	string	Geräteart, vorerst «ev_charger»
`livemode`required	boolean
`name`required	string
`location_id`required	string
`integration_id`required	string \| null
`manufacturer`required	string \| null
`model`required	string \| null
`serial_number`required	string \| null
`max_power_w`required	integer \| null
`tariff_id`required	string \| null
`billing`required	object	Abrechnungsmodell, Reservationsgrenzen, Pakete
`enabled`required	boolean	Von Ladehase verwaltet und für Fahrende freigegeben
`locked`required	boolean	Vorübergehend gesperrt (keine neuen Ladungen)
`prepared`required	boolean	«Autorisierung erforderlich» beim Hersteller gesetzt
`status`required	string	Zusammengefasster Status für Anzeigen
`state`required	DeviceState
`active_session_id`required	string \| null
`connectors`required	object[]
`created_at`required	string

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X POST https://api.ladehase.com/v1/devices/{id}/unlock \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "id": "dev_7d3a9c1b0e2f4a6b",
  "object": "device",
  "kind": "string",
  "livemode": true,
  "name": "Ladepunkt Scheune",
  "location_id": "string",
  "integration_id": "string",
  "manufacturer": "string",
  "model": "string",
  "serial_number": "string",
  "max_power_w": 0,
  "tariff_id": "string",
  "billing": {},
  "enabled": true,
  "locked": true,
  "prepared": true,
  "status": "string",
  "state": {
    "online": true,
    "status": "string",
    "cable_plugged": true,
    "power_w": 0,
    "meter_wh": 0,
    "authorization_required": true,
    "last_seen_at": "2026-10-25T08:30:00.000Z",
    "error": "string"
  },
  "active_session_id": "string",
  "connectors": [
    {
      "id": "string",
      "code": "string",
      "url": "string"
    }
  ],
  "created_at": "string"
}

Testgerät steuern

post/v1/devices/{id}/simulate

Nur Testmodus: simuliertes Auto anstecken (`plug`), abziehen (`unplug`), offline, Störung, Leistung ändern.

Parameters

Name	In	Type
`id`required	Path	string
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Request

Name	Type	Description
`action`required	"plug" \| "unplug" \| "offline" \| "online" \| "error" \| "clear_error" \| "set_power"
`vehicle_need_wh`optional	integer
`power_w`optional	integer

Response 200DeviceState

Name	Type	Description
`online`optional	boolean
`status`optional	string	offline, available, vehicle_connected, awaiting_authorization, charging, suspended, finished, error
`cable_plugged`optional	boolean
`power_w`optional	integer	Aktuelle Leistung in Watt
`meter_wh`optional	integer \| null	Zählerstand in Wh
`authorization_required`optional	boolean \| null
`last_seen_at`optional	string \| null	Zeitpunkt (ISO 8601, UTC)
`error`optional	string \| null

Possible errors

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Example

curl -X POST https://api.ladehase.com/v1/devices/{id}/simulate \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"action":"plug","vehicle_need_wh":0,"power_w":0}'

Response 200

{
  "online": true,
  "status": "string",
  "cable_plugged": true,
  "power_w": 0,
  "meter_wh": 0,
  "authorization_required": true,
  "last_seen_at": "2026-10-25T08:30:00.000Z",
  "error": "string"
}