The Fleet object

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

string

Unique identifier for the object.

string | null

Contact email associated with the fleet.

string

Human-readable name of the fleet.

object

Account-level settings related to billing, reporting, and charging activity.

Show properties

string

Frequency of billing for the fleet (monthly, weekly, etc.).

string

Preferred currency for cost estimates and billing.

string

ID of the default payment method to use for charging sessions.

boolean

Whether drivers in this fleet receive session status notifications.

string

Frequency of automated report delivery (weekly, monthly, etc.).

string

Current operational status of the fleet.Available options: active, suspended, archived

integer

Number of drivers currently assigned to this fleet.

integer

Number of vehicles currently assigned to this fleet.

More attributes

string

String representing the object’s type.

object

Physical address associated with the fleet’s headquarters or billing location.

Show properties

string

City, district, or town.

string

Two-letter ISO country code.

string

First line of the street address.

string

Second line of the address.

string

ZIP or postal code.

string

State, province, or region.

string

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

string | null

Optional description for the fleet.

object

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

string

Unit system preferred for reports and distance/energy formats.Available options: international_system, us_customary_system, imperial_system

string | null

Optional phone number associated with the fleet.

array of string

A list of policy IDs to apply to this fleet.

string

IANA timezone identifier used for reporting and scheduling.

number

Total historical energy consumed by the fleet across all sessions (in kWh).

integer

Total number of charging sessions completed by the fleet.

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.

integer

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

Getting Started

API Behavior

API Reference

The Fleet object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes