Skip to main content
curl -X POST https://api.chargeapi.co/v1/charging_sessions \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "charging_station": "chst_dxNYlw4nSLzUm4GWwPJ5ochwR3myCKsA",
  "connector": "connector_a1",
  "driver": "drv_AxAS7yPHekpPhbGMcO4wAAZrt3OA9mEc",
  "payment_method": "pm_BEAD5NIY9aCx3nSplzYUe7cxJ6QkI1BD",
  "vehicle": "veh_s2hlA8r7yI5C1Xo8bjJyglHiJBegvTA3"
}'
{
    "id": "cs_ccJe4CNvGc5CRBiPnoPEPrZUuCfPqUbY",
    "object": "charging_session",
    "amount_due": 1842,
    "amount_paid": 0,
    "charging_station": "chst_dxNYlw4nSLzUm4GWwPJ5ochwR3myCKsA",
    "connector": "connector_a1",
    "country": "FR",
    "created": "2026-04-01T01:09:14.087Z",
    "currency": "eur",
    "driver": "drv_AxAS7yPHekpPhbGMcO4wAAZrt3OA9mEc",
    "energy_consumed": 0,
    "fleet": "flt_VPncsNUF64r6IMozGsQXGXBrA3USpxxb",
    "payment_method": "pm_BEAD5NIY9aCx3nSplzYUe7cxJ6QkI1BD",
    "session_ended": null,
    "session_limit": null,
    "session_started": "2026-04-01T01:15:03.983Z",
    "status": "active",
    "updated": "2026-04-01T01:18:50.258Z",
    "vehicle": "veh_s2hlA8r7yI5C1Xo8bjJyglHiJBegvTA3"
}
Creates a charging session and starts power delivery on the requested connector. The session remains active until you end it or the charging station stops delivering power. On success, the response returns the live session object with its start time and any authorization details.
curl -X POST https://api.chargeapi.co/v1/charging_sessions \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "charging_station": "chst_dxNYlw4nSLzUm4GWwPJ5ochwR3myCKsA",
  "connector": "connector_a1",
  "driver": "drv_AxAS7yPHekpPhbGMcO4wAAZrt3OA9mEc",
  "payment_method": "pm_BEAD5NIY9aCx3nSplzYUe7cxJ6QkI1BD",
  "vehicle": "veh_s2hlA8r7yI5C1Xo8bjJyglHiJBegvTA3"
}'
{
    "id": "cs_ccJe4CNvGc5CRBiPnoPEPrZUuCfPqUbY",
    "object": "charging_session",
    "amount_due": 1842,
    "amount_paid": 0,
    "charging_station": "chst_dxNYlw4nSLzUm4GWwPJ5ochwR3myCKsA",
    "connector": "connector_a1",
    "country": "FR",
    "created": "2026-04-01T01:09:14.087Z",
    "currency": "eur",
    "driver": "drv_AxAS7yPHekpPhbGMcO4wAAZrt3OA9mEc",
    "energy_consumed": 0,
    "fleet": "flt_VPncsNUF64r6IMozGsQXGXBrA3USpxxb",
    "payment_method": "pm_BEAD5NIY9aCx3nSplzYUe7cxJ6QkI1BD",
    "session_ended": null,
    "session_limit": null,
    "session_started": "2026-04-01T01:15:03.983Z",
    "status": "active",
    "updated": "2026-04-01T01:18:50.258Z",
    "vehicle": "veh_s2hlA8r7yI5C1Xo8bjJyglHiJBegvTA3"
}

Parameters

charging_station
string
required
ID of the station where charging will occur.
connector
string
required
ID of the specific connector to activate.
driver
string
required
ID of the driver starting the session.
payment_method
string
required
ID of the payment method to authorize and bill for this session.
vehicle
string
required
ID of the vehicle being charged.

More parameters

session_limit
integer
Optional energy limit in watt-hours to auto-stop charging when reached.

Returns

Returns the created charging session.