> ## 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.

# List Charging Sessions

Returns a paginated list of charging session objects. Use `driver`, `fleet`, or `vehicle` to scope results, then follow the returned page URLs to continue through the result set.

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.chargeapi.co/v1/charging_sessions \
    -H "Authorization: Bearer ch_sk_test_..." \
    -d driver=drv_MeVPeA4p1YkuWfAFBkMw7ic0tFccgUth \
    -d limit=10
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "id": "cs_AL1gQKYwRle76eKq2ecf3AR88uVOoAj4",
              "object": "charging_session",
              "amount_due": 1842,
              "amount_paid": 0,
              "charging_station": "chst_l3AWdoy5rP8bBPVJODn8TPpdxQTAsYAK",
              "connector": "connector_a1",
              "country": "FR",
              "created": "2026-04-01T01:18:22.807Z",
              "currency": "eur",
              "driver": "drv_MeVPeA4p1YkuWfAFBkMw7ic0tFccgUth",
              "energy_consumed": 12480,
              "fleet": "flt_OA3cCKUR7yRYIp0WX0pVUZ4Uw6OoBWJk",
              "payment_method": "pm_siAYwdA3MAc9Hs0oMtgWhDXSbA3xfqiU",
              "session_ended": null,
              "session_limit": null,
              "session_started": "2026-04-01T01:24:13.285Z",
              "status": "active",
              "updated": "2026-04-01T01:53:58.446Z",
              "vehicle": "veh_CAfwCp0gh3fVUUqhbaPupXynUVgbdQxr"
          }
      ],
      "next_page_url": "https://api.chargeapi.co/v1/charging_sessions?page=page_vTAqG8c9R32ps8le7rxCVudUeguIaNstI0LBO09jrOg&driver=drv_MeVPeA4p1YkuWfAFBkMw7ic0tFccgUth&limit=10",
      "previous_page_url": null
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="driver" type="string">
  Limit results to charging sessions for this driver.
</ParamField>

<ParamField query="fleet" type="string">
  Limit results to charging sessions for this fleet.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of objects to return (default 10).
</ParamField>

<ParamField query="page" type="string">
  Page token from a previous list response.
</ParamField>

<ParamField query="status" type="string">
  Filter charging sessions by status.

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

<ParamField query="vehicle" type="string">
  Limit results to charging sessions for this vehicle.
</ParamField>

## More parameters

<ParamField query="created" type="string | object">
  Range filter on the `created` time. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.

  <Expandable title="properties">
    <ParamField body="gt" type="string">
      Minimum `created` time (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ParamField>

    <ParamField body="gte" type="string">
      Minimum `created` time (inclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ParamField>

    <ParamField body="lt" type="string">
      Maximum `created` time (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ParamField>

    <ParamField body="lte" type="string">
      Maximum `created` time (inclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ParamField>
  </Expandable>
</ParamField>

## Returns

Returns a page of charging sessions.

<ResponseField name="data" type="array of object" required>
  Array of charging session objects.
</ResponseField>

<ResponseField name="next_page_url" type="string | null" required>
  URL for the next page of results, or `null` when there is no next page.
</ResponseField>

<ResponseField name="previous_page_url" type="string | null" required>
  URL for the previous page of results, or `null` when there is no previous page.
</ResponseField>