Skip to main content
{
    "id": "flt_nnMosKd4naheDFTiLmLhZ3Yw64xg9enI",
    "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:24:36.653Z",
    "description": null,
    "email": "example@example.com",
    "metadata": {},
    "metric_system": "international_system",
    "name": "Example Fleet",
    "phone": null,
    "policy_ids": ["pol_AGfBZOUmASNfvtGqjDwK8byoVlMzuAll"],
    "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:24:44.642Z",
    "wallet_balance": 32150
}

{
    "id": "flt_nnMosKd4naheDFTiLmLhZ3Yw64xg9enI",
    "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:24:36.653Z",
    "description": null,
    "email": "example@example.com",
    "metadata": {},
    "metric_system": "international_system",
    "name": "Example Fleet",
    "phone": null,
    "policy_ids": ["pol_AGfBZOUmASNfvtGqjDwK8byoVlMzuAll"],
    "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:24:44.642Z",
    "wallet_balance": 32150
}
This object represents a fleet in Charge. Use it to group drivers, vehicles, payment settings, and reporting under one operational unit.

​
Attributes

​
id
string
Unique identifier for the object.
​
email
string | null
Contact email associated with the fleet.
​
name
string
Human-readable name of the fleet.
​
preferences
object
Account-level settings related to billing, reporting, and charging activity.
​
status
string
Current operational status of the fleet.Available options: active, suspended, archived
​
total_drivers
integer
Number of drivers currently assigned to this fleet.
​
total_vehicles
integer
Number of vehicles currently assigned to this fleet.

​
More attributes

​
object
string
String representing the object’s type.
​
address
object
Physical address associated with the fleet’s headquarters or billing location.
​
created
string
Time at which the fleet was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
description
string | null
Optional description for the fleet.
​
metadata
object
Set of key-value pairs that you can attach to an object.
​
metric_system
string
Unit system preferred for reports and distance/energy formats.Available options: international_system, us_customary_system, imperial_system
​
phone
string | null
Optional phone number associated with the fleet.
​
policy_ids
array of string
A list of policy IDs to apply to this fleet.
​
timezone
string
IANA timezone identifier used for reporting and scheduling.
​
total_energy_consumed_kwh
number
Total historical energy consumed by the fleet across all sessions (in kWh).
​
total_sessions
integer
Total number of charging sessions completed by the fleet.
​
updated
string
Time at which the fleet object was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
wallet_balance
integer
Fleet’s current wallet or prepaid balance in the smallest currency unit.