Sitzungen

6 endpoints

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

Sitzungen auflisten

get/v1/sessions

Ladungen, neueste zuerst. Filter: state (kommagetrennt), device_id, location_id, access_grant_id, from, to.

Parameters

Name	In	Type
`limit`optional	Query	integer
`starting_after`optional	Query	string
`state`optional	Query	string
`device_id`optional	Query	string
`location_id`optional	Query	string
`access_grant_id`optional	Query	string
`from`optional	Query	string (date-time)
`to`optional	Query	string (date-time)

Response 200SessionList

Name	Type	Description
`object`required	"list"
`data`required	Session[]
`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/sessions \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": true
}

Sitzung starten

post/v1/sessions

Startet eine Ladung ohne Zahlung über die API (z. B. für eigene Apps oder Weiterverrechnung). Mit `access_grant_id` gilt der Sondertarif des Zugangs.

Parameters

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

Request

Name	Type	Description
`device_id`required	string
`access_grant_id`optional	string
`metadata`optional	object

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/sessions \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"device_id":"string","access_grant_id":"string","metadata":{}}'

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

Sitzung abrufen

get/v1/sessions/{id}

Eine Ladung mit Beträgen, Energie und Preisaufstellung.

Parameters

Name	In	Type
`id`required	Path	string

Response 200Session

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 GET https://api.ladehase.com/v1/sessions/{id} \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "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"
}

Sitzung stoppen

post/v1/sessions/{id}/stop

Stoppt die Ladung. Abgerechnet wird automatisch.

Parameters

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

Response 200Session

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/sessions/{id}/stop \n  -H "Authorization: Bearer lh_test_…"

Response 200

{
  "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"
}

Zeitleiste einer Sitzung

get/v1/sessions/{id}/events

Alle Zustandswechsel und Messwerte (Ladekurve).

Parameters

Name	In	Type
`id`required	Path	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 GET https://api.ladehase.com/v1/sessions/{id}/events \n  -H "Authorization: Bearer lh_test_…"

Response 200

{}

Rückerstatten

post/v1/sessions/{id}/refund

Voll oder teilweise (`amount` in Rappen).

Parameters

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

Request

Name	Type	Description
`amount`optional	integer
`reason`optional	string

Response 200Session

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/sessions/{id}/refund \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"amount":0,"reason":"string"}'

Response 200

{
  "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"
}