> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Charging Session object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Charging Session object theme={null}
    {
        "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"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Charging Session object theme={null}
    {
        "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"
    }
    ```
  </ResponseExample>
</div>

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

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="amount_due" type="integer">
  Total cost of the charging session, in the smallest currency unit.
</ResponseField>

<ResponseField name="charging_station" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the charging station used for the session.
</ResponseField>

<ResponseField name="driver" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the driver associated with the session.
</ResponseField>

<ResponseField name="payment_method" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the payment method used for the session.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the session.

  Available options: `active`, `completed`, `cancelled`, `failed`
</ResponseField>

<ResponseField name="vehicle" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the vehicle associated with the session.
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="amount_paid" type="integer">
  Amount already paid for the charging session, in the smallest currency unit.
</ResponseField>

<ResponseField name="connector" type="string">
  ID of the specific connector used during the session.
</ResponseField>

<ResponseField name="country" type="string | null">
  Country code (ISO 3166-1 alpha-2) where the session took place.
</ResponseField>

<ResponseField name="created" type="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`.
</ResponseField>

<ResponseField name="currency" type="string">
  ISO 4217 three-letter currency code.
</ResponseField>

<ResponseField name="energy_consumed" type="integer">
  Amount of energy delivered during the session, in watt-hours (Wh).
</ResponseField>

<ResponseField name="fleet" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the fleet associated with the session, if any.
</ResponseField>

<ResponseField name="session_ended" type="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`.
</ResponseField>

<ResponseField name="session_limit" type="integer | null">
  Optional energy limit in watt-hours that automatically stops the session when reached.
</ResponseField>

<ResponseField name="session_started" type="string">
  Time at which the charging session started. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="updated" type="string">
  Time at which the session was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>