Skip to main content
{
    "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

​
id
string
Unique identifier for the object.
​
email
string
Email address used for login and notifications.
​
name
string
Full name of the driver.
​
phone
string | null
Optional phone number for communication and account recovery.
​
preferences
object
Driver preferences for charging behavior and routing.
​
status
string
Current status of the driver account.Available options: active, suspended, archived

​
More attributes

​
object
string
String representing the object’s type.
​
created
string
Time at which the driver was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
fleets
array of string
List of fleet IDs currently linked to the driver.
​
license_number
string | null
Driver’s license number, if applicable.
​
metadata
object
Set of key-value pairs that you can attach to an object.
​
policy_ids
array of string
A list of policy IDs to apply to this driver.
​
updated
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.
​
vehicles
array of string
List of vehicle IDs currently linked to the driver.
​
wallet_balance
integer
Driver’s wallet or prepaid balance in the smallest currency unit.