Getting Started
Capacitor is a headless OCPP 1.6J backend with a REST API. Connect EV chargers, manage charging sessions, and receive real-time events — all through a simple API.
Base URL
Production
text
https://capacitor.live/api/v1
Quickstart
Register your first charger
Use your API key to register a charger. The response includes a WebSocket URL for the charger to connect to.
Register a charger
bash
curl -X POST https://capacitor.live/api/v1/chargers \-H "X-API-Key: cap_live_sk_..." \-H "Content-Type: application/json" \-d '{"chargeBoxId": "CHARGER-001","name": "Office Parking Lot"}'
Connect the charger
Point your OCPP 1.6J charger to the WebSocket URL from the registration response. It will connect and send a BootNotification automatically.
Response
json
{"chargeBoxId": "CHARGER-001","name": "Office Parking Lot","status": "offline","connectionUrl": "wss://capacitor.live/ocpp/CHARGER-001","instructions": {"message": "Configure your charger to connect to the WebSocket URL","url": "wss://capacitor.live/ocpp/CHARGER-001","protocol": "ocpp1.6"}}
Start a charging session
Once the charger is connected and a vehicle is plugged in, start a session remotely via the API.
Remote start
bash
curl -X POST https://capacitor.live/api/v1/chargers/CHARGER-001/remote-start \-H "X-API-Key: cap_live_sk_..." \-H "Content-Type: application/json" \-d '{"connectorId": 1, "idTag": "USER001"}'
The connector must be in Preparing status (cable plugged in) for a remote start to succeed.