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

Returns a paginated list of fleet objects. Filter by `status`, `driver`, or `vehicle`, then follow the returned page URLs to continue through the result set.

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

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "id": "flt_QYNjvq8666Ar0hjA86iwlVrwA3cmyX7q",
              "object": "fleet",
              "address": {
                  "city": "Paris",
                  "country": "FR",
                  "line1": "10 Rue de la Paix",
                  "line2": "Batiment A",
                  "postal_code": "75002",
                  "state": "Ile-de-France"
              },
              "created": "2026-04-01T00:17:18.631Z",
              "description": null,
              "email": "example@example.com",
              "metadata": {},
              "metric_system": "international_system",
              "name": "Example Fleet",
              "phone": null,
              "policy_ids": ["pol_kAEdXgOYG1SpwWQFckETc6i4Bri6J4A2"],
              "preferences": {
                  "billing_cycle": "monthly",
                  "default_currency": "eur",
                  "default_payment_method": null,
                  "notifications": true,
                  "report_frequency": "weekly"
              },
              "status": "active",
              "timezone": "Europe/Paris",
              "total_drivers": 24,
              "total_energy_consumed_kwh": 4825.4,
              "total_sessions": 186,
              "total_vehicles": 18,
              "updated": "2026-04-01T01:17:00.697Z",
              "wallet_balance": 32150
          }
      ],
      "next_page_url": "https://api.chargeapi.co/v1/fleets?page=page_Ea2sjDaQX5sSMXjFDV6LAimqAIt3JLkhFCPnAKowspQ&status=active&limit=10",
      "previous_page_url": null
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="driver" type="string">
  Limit results to fleets linked to this driver.
</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">
  Limit results to fleets with this status.

  Available options: `active`, `suspended`, `archived`
</ParamField>

<ParamField query="vehicle" type="string">
  Limit results to fleets linked to this vehicle.
</ParamField>

## Returns

Returns a page of fleets.

<ResponseField name="data" type="array of object" required>
  Array of fleet 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>