Create a Charging Session

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"
}

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

string

required

ID of the station where charging will occur.

string

required

ID of the specific connector to activate.

string

required

ID of the driver starting the session.

string

required

ID of the payment method to authorize and bill for this session.

string

required

ID of the vehicle being charged.

More parameters

integer

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

Returns

Returns the created charging session.

Getting Started

API Behavior

API Reference

Create a Charging Session

Parameters

More parameters

Returns

​Parameters

​More parameters

​Returns

Parameters

More parameters

Returns