Accessing your data via the API
Retrieve your own charge sessions and chargers with a personal API key.
Want to use your charging data in your own tools — for example Home Assistant, a spreadsheet or your own dashboard? You can, via our API. You only get access to your own data.
Creating an API key
- Sign in to the portal and go to Settings → API keys.
- Give the key a recognizable name and click Create key.
- Copy the key immediately — it is shown only once. Lost it? Revoke the key and create a new one.
Treat your key like a password: don't share it and don't put it in public code.
Authentication
Send your key as a header with every request:
X-Api-Key: ck_your_key
Endpoints
Charge sessions
GET /api/v1/sessions?from=2026-01-01T00:00:00Z&limit=100&offset=0
Parameters: from and to (ISO 8601), chargerId, limit (max. 200) and offset for pagination. The response contains, per session, the start and end of energy transfer, the plug-in and unplug times and the kWh.
Chargers
GET /api/v1/chargers
Returns your connected charging stations with brand, model, serial number, MID status and connection status.
Example
curl -H "X-Api-Key: ck_your_key" \
"https://ere-production.up.railway.app/api/v1/sessions?limit=5"
Fair use
- Keys give read access to your own data only.
- Be reasonable with request frequency (fair use); your data refreshes hourly, so polling more often has no benefit.
- Revoking a key takes effect immediately.
Ready to earn with your charger?
Create a free account — Revvolt handles NEa registration, the sale and the payout of your EREs.