The Driver object

{
    "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
}

{
    "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
}

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

Attributes

string

Unique identifier for the object.

string

Email address used for login and notifications.

string

Full name of the driver.

string | null

Optional phone number for communication and account recovery.

object

Driver preferences for charging behavior and routing.

Show properties

string

Preferred charging speed.

string

Preferred currency for cost display and billing.

string | null

Default payment method ID assigned to the driver.

integer | null

Optional upper limit on acceptable charging price, in the smallest currency unit per kWh.

boolean

Whether to receive notifications about charging status and session progress.

array of string

List of preferred charging station IDs.

array of string

List of preferred charging network (CPO) IDs.

string

Current status of the driver account.Available options: active, suspended, archived

More attributes

string

String representing the object’s type.

string

Time at which the driver was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

array of string

List of fleet IDs currently linked to the driver.

string | null

Driver’s license number, if applicable.

object

Set of key-value pairs that you can attach to an object.

array of string

A list of policy IDs to apply to this driver.

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.

array of string

List of vehicle IDs currently linked to the driver.

integer

Driver’s wallet or prepaid balance in the smallest currency unit.

Getting Started

API Behavior

API Reference

The Driver object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes