> ## 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 Driver object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Driver object theme={null}
    {
        "id": "drv_rc5aCZyDxMT6ZAORNxsNnsFXvdP1CqB3",
        "object": "driver",
        "created": "2026-04-01T00:14:04.075Z",
        "email": "example@example.com",
        "fleets": ["flt_eHX2bF02REQ3CkjidnUeY8nvq8yJiWA3"],
        "license_number": null,
        "metadata": {},
        "name": "Example Driver",
        "phone": null,
        "policy_ids": ["pol_jVkWoUmJo3AuAyK1sHuRrNAu3Cj7rxSn"],
        "preferences": {
            "charging_speed": "fast",
            "currency": "eur",
            "default_payment_method": null,
            "max_price_per_kwh": null,
            "notifications": true,
            "preferred_charging_stations": ["chst_qtwELQheAdAmnYLZ4F6RgJZet3f7ZbrA"],
            "preferred_cpos": ["example_operator"]
        },
        "status": "active",
        "updated": "2026-04-01T01:13:51.435Z",
        "vehicles": ["veh_ASPMuIbvn8wrb9un5Zg2sQAoDXAxWLHt"],
        "wallet_balance": 1875
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Driver object theme={null}
    {
        "id": "drv_rc5aCZyDxMT6ZAORNxsNnsFXvdP1CqB3",
        "object": "driver",
        "created": "2026-04-01T00:14:04.075Z",
        "email": "example@example.com",
        "fleets": ["flt_eHX2bF02REQ3CkjidnUeY8nvq8yJiWA3"],
        "license_number": null,
        "metadata": {},
        "name": "Example Driver",
        "phone": null,
        "policy_ids": ["pol_jVkWoUmJo3AuAyK1sHuRrNAu3Cj7rxSn"],
        "preferences": {
            "charging_speed": "fast",
            "currency": "eur",
            "default_payment_method": null,
            "max_price_per_kwh": null,
            "notifications": true,
            "preferred_charging_stations": ["chst_qtwELQheAdAmnYLZ4F6RgJZet3f7ZbrA"],
            "preferred_cpos": ["example_operator"]
        },
        "status": "active",
        "updated": "2026-04-01T01:13:51.435Z",
        "vehicles": ["veh_ASPMuIbvn8wrb9un5Zg2sQAoDXAxWLHt"],
        "wallet_balance": 1875
    }
    ```
  </ResponseExample>
</div>

This object represents a driver in Charge. Use it to manage charging access, preferences, vehicle assignments, and fleet membership.

## Attributes

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

<ResponseField name="email" type="string">
  Email address used for login and notifications.
</ResponseField>

<ResponseField name="name" type="string">
  Full name of the driver.
</ResponseField>

<ResponseField name="phone" type="string | null">
  Optional phone number for communication and account recovery.
</ResponseField>

<ResponseField name="preferences" type="object">
  Driver preferences for charging behavior and routing.

  <Expandable title="properties">
    <ResponseField name="charging_speed" type="string">
      Preferred charging speed.
    </ResponseField>

    <ResponseField name="currency" type="string">
      Preferred currency for cost display and billing.
    </ResponseField>

    <ResponseField name="default_payment_method" type="string | null" 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>]}>
      Default payment method ID assigned to the driver.
    </ResponseField>

    <ResponseField name="max_price_per_kwh" type="integer | null">
      Optional upper limit on acceptable charging price, in the smallest currency unit per kWh.
    </ResponseField>

    <ResponseField name="notifications" type="boolean">
      Whether to receive notifications about charging status and session progress.
    </ResponseField>

    <ResponseField name="preferred_charging_stations" type="array of string">
      List of preferred charging station IDs.
    </ResponseField>

    <ResponseField name="preferred_cpos" type="array of string">
      List of preferred charging network (CPO) IDs.
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

## More attributes

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

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

<ResponseField name="fleets" type="array of string">
  List of fleet IDs currently linked to the driver.
</ResponseField>

<ResponseField name="license_number" type="string | null">
  Driver's license number, if applicable.
</ResponseField>

<ResponseField name="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ResponseField>

<ResponseField name="policy_ids" type="array of string">
  A list of policy IDs to apply to this driver.
</ResponseField>

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

<ResponseField name="vehicles" type="array of string">
  List of vehicle IDs currently linked to the driver.
</ResponseField>

<ResponseField name="wallet_balance" type="integer">
  Driver's wallet or prepaid balance in the smallest currency unit.
</ResponseField>