Start charging session​

POST
/sessions/start

Sends an OCPP remote-start request to the selected connector. The charger must be online and initialized, charging must be enabled, and the connector must not already have an active session. A successful response has status pending: the charger accepted the command but has not yet confirmed that charging started.

Use cases

  • Start charging from an authenticated app or operator-console workflow.

Related endpoints

  • GET /sessions/{chargingSessionId} — check whether the charger moved the session from pending to in_progress.
  • POST /sessions/{chargingSessionId}/stop — stop an active session.
  • GET /sessions/{chargingSessionId}/meter-data — retrieve the session’s OCPP meter readings.

Authorizations​

bearerAuth

Generate an API token here

Type
HTTP (bearer)

Parameters​

Header Parameters

compatibility-date*

API compatibility date in YYYY-MM-DD format. Must be a date after 2025-11-01.

Type
string
Required
Example"2025-11-02"
Pattern
^\d{4}-\d{2}-\d{2}$

Request Body​

application/json

CleverEV-generated charger ID used in charger path parameters.

Min Length1
Max Length40

OCPP connector number from the charger record; select a connector that is available for charging.

Exclusive Minimum0
Maximum255

Use app for a user-initiated start or console for an operator-initiated start.

Valid values"app""console"

Responses​

session.start

application/json

Playground​

Authorization
Headers
Body

Samples​