> For the complete documentation index, see [llms.txt](https://docs.pumpapp.co/pump-connect/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pumpapp.co/pump-connect/entwickler/pump-connect/ladevorgange.md).

# Ladevorgänge

Auflistung aller Ladevorgänge die über PUMP connect stattgefunden haben.

Über den Endpunkt <mark style="background-color:blue;">/sessions</mark> können alle Ladevorgänge abgerufen werden.

#### Optionale Parameter

| Parameter      | Beschreibung                                                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| auth\_type     | Die Autorisierungsmethode für den Ladevorgang. Entweder ADHOC\_CONNECT, APPCLIP\_PUMP, APP\_PUMP, LOCAL\_CONNECT, REMOTE\_CONNECT, REMOTE\_SHARED\_CONNECT oder ROAMING. |
| device\_id     | Die eindeutige ID der Ladestation. Zu finden auf der Platform unter Standorte -> {Standort} -> {Ladestation} -> Tab 'Hilfe'.                                             |
| site\_id       | Die eindeutige ID des Standortes. Zu finden auf der Platform unter Standorte -> {Standort} -> {Ladestation} -> Tab 'Hilfe'.                                              |
| identifier\_id | Die eindeutige ID der Ladekarte. Zu finden auf der Platform unter Ladekarten.                                                                                            |
| status         | Der Status des Ladevorgangs. Entweder PREPARING, STARTING, ACTIVE, REMOTE\_STOPPED, CLOSED, FAILED oder INVALID.                                                         |
| page           | Die aktuelle Seite der Ergebnisse.                                                                                                                                       |
| per\_page      | Die Anzahl von Ergebnissen pro Seite. Minimal 1 und maximal 500.                                                                                                         |
| start\_date    | Gibt nur Ladevorgänge zurück die ab dem angegebenem Datum gestartet wurden. Das Format ist in ISO 8601, zum Beispiel 2025-01-01T00:00:00Z                                |
| end\_date      | Gibt nur Ladevorgänge zurück die bis zu dem angegebenem Datum gestartet wurden. Das Format ist in ISO 8601, zum Beispiel 2025-01-01T00:00:00Z                            |

Das folgende Beispiel zeigt eine Auflistung aller Aktive Ladevorgänge.

{% code lineNumbers="true" %}

```
curl --request GET \
  --url 'https://data.800volt.de/public/connect/1/sessions?status=ACTIVE' \
  --header 'Accept-Encoding: gzip' \
  --header 'x-api-key: YOUR_API_KEY'
```

{% endcode %}

Das Ergebnis ist eine Liste aller aktiver Ladevorgänge.

{% code lineNumbers="true" %}

```json
{
    "sessions": [{
	"id": "SESSION_ID",
	"auth_type": "REMOTE",
	"status": "ACTIVE",
	"started_at": 1695383249,
	"completed_at": null,
	"last_updated_at": 1695383358,
	"organization_id": "YOUR_ORGANIZATION_ID",
	"device_connector_id": 1,
	"energy_in_kwh": 5.5,
	"duration_in_minutes": 20,
	"identifier_id": "YOUR_CHARGE_KEY_ID",
	"identifier_uid_code": "XXXXXXXX"
    }]
}
```

{% endcode %}