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

Returns a paginated list of driver objects. Filter by `fleet` 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/drivers \
    -H "Authorization: Bearer ch_sk_test_..." \
    -d fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy \
    -d limit=10
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "id": "drv_AJASUAMPlJ1wb08CYreqlKp3VzSXyv1h",
              "object": "driver",
              "created": "2026-04-01T00:31:50.123Z",
              "email": "example@example.com",
              "fleets": ["flt_ZfAR51ZcdY4kD5iGDCoO54XxNBnvut9A"],
              "license_number": null,
              "metadata": {},
              "name": "Example Driver",
              "phone": null,
              "policy_ids": ["pol_tOj9AM6C9NmHzPhe5nL2hJA6I8qxMBaH"],
              "preferences": {
                  "charging_speed": "fast",
                  "currency": "eur",
                  "default_payment_method": null,
                  "max_price_per_kwh": null,
                  "notifications": true,
                  "preferred_charging_stations": ["chst_MX4W8KNDAkqQ4dsIF20bAIFP1cG8vd35"],
                  "preferred_cpos": ["example_operator"]
              },
              "status": "active",
              "updated": "2026-04-01T01:31:12.889Z",
              "vehicles": ["veh_R7WSj5phl1GsQShw0ZmhsXF1HpIBObAO"],
              "wallet_balance": 1875
          }
      ],
      "next_page_url": "https://api.chargeapi.co/v1/drivers?page=page_7OgQMYt5hfPHsdDCa6pbupMyxLxTnoTBCsDV7Wp2rlw&fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy&limit=10",
      "previous_page_url": null
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="fleet" type="string">
  Limit results to drivers attached to 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="vehicle" type="string">
  Limit results to drivers attached to this vehicle.
</ParamField>

## Returns

Returns a page of drivers.

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