The Charging Session object

{
    "id": "cs_l22tJO0CuTskKYpTv729awh03sRWnijk",
    "object": "charging_session",
    "amount_due": 1842,
    "amount_paid": 0,
    "charging_station": "chst_AEoFA0Hzg73oTdE4A78y1AwQ1qqB8aUZ",
    "connector": "connector_a1",
    "country": "FR",
    "created": "2026-04-01T01:27:11.867Z",
    "currency": "eur",
    "driver": "drv_IsyNzuUkgSd0RAThYiU4nmteVRpI7kPl",
    "energy_consumed": 12480,
    "fleet": "flt_hoPDrnmp1zSdbAA5NanAPDIwSQg88sfy",
    "payment_method": "pm_ItBHV1QUL1PAnNZmCFX2aBJdppmeiJTz",
    "session_ended": null,
    "session_limit": null,
    "session_started": "2026-04-01T01:32:56.030Z",
    "status": "active",
    "updated": "2026-04-01T02:02:58.111Z",
    "vehicle": "veh_KnqAScicQNI3X1Fj0RL79Y1H0TA2bVMt"
}

{
    "id": "cs_l22tJO0CuTskKYpTv729awh03sRWnijk",
    "object": "charging_session",
    "amount_due": 1842,
    "amount_paid": 0,
    "charging_station": "chst_AEoFA0Hzg73oTdE4A78y1AwQ1qqB8aUZ",
    "connector": "connector_a1",
    "country": "FR",
    "created": "2026-04-01T01:27:11.867Z",
    "currency": "eur",
    "driver": "drv_IsyNzuUkgSd0RAThYiU4nmteVRpI7kPl",
    "energy_consumed": 12480,
    "fleet": "flt_hoPDrnmp1zSdbAA5NanAPDIwSQg88sfy",
    "payment_method": "pm_ItBHV1QUL1PAnNZmCFX2aBJdppmeiJTz",
    "session_ended": null,
    "session_limit": null,
    "session_started": "2026-04-01T01:32:56.030Z",
    "status": "active",
    "updated": "2026-04-01T02:02:58.111Z",
    "vehicle": "veh_KnqAScicQNI3X1Fj0RL79Y1H0TA2bVMt"
}

This object represents a charging session in Charge. It captures the operational and billing record for a vehicle charging at a station.

Attributes

string

Unique identifier for the object.

integer

Total cost of the charging session, in the smallest currency unit.

string

ID of the charging station used for the session.

string

ID of the driver associated with the session.

string

ID of the payment method used for the session.

string

Current status of the session.Available options: active, completed, cancelled, failed

string

ID of the vehicle associated with the session.

More attributes

string

String representing the object’s type.

integer

Amount already paid for the charging session, in the smallest currency unit.

string

ID of the specific connector used during the session.

string | null

Country code (ISO 3166-1 alpha-2) where the session took place.

string

Time at which the charging session was created or initialized. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

ISO 4217 three-letter currency code.

integer

Amount of energy delivered during the session, in watt-hours (Wh).

string

ID of the fleet associated with the session, if any.

string | null

Time at which the charging session ended, if completed. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

integer | null

Optional energy limit in watt-hours that automatically stops the session when reached.

string

Time at which the charging session started. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

Time at which the session was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

Getting Started

API Behavior

API Reference

The Charging Session object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes