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

<div className="xl:hidden">
  <CodeGroup>
    ```json The Fleet object theme={null}
    {
        "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
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Fleet object theme={null}
    {
        "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
    }
    ```
  </ResponseExample>
</div>

This object represents a fleet in Charge. Use it to group drivers, vehicles, payment settings, and reporting under one operational unit.

## Attributes

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

<ResponseField name="email" type="string | null">
  Contact email associated with the fleet.
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable name of the fleet.
</ResponseField>

<ResponseField name="preferences" type="object">
  Account-level settings related to billing, reporting, and charging activity.

  <Expandable title="properties">
    <ResponseField name="billing_cycle" type="string">
      Frequency of billing for the fleet (`monthly`, `weekly`, etc.).
    </ResponseField>

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

    <ResponseField name="default_payment_method" type="string" 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>]}>
      ID of the default payment method to use for charging sessions.
    </ResponseField>

    <ResponseField name="notifications" type="boolean">
      Whether drivers in this fleet receive session status notifications.
    </ResponseField>

    <ResponseField name="report_frequency" type="string">
      Frequency of automated report delivery (`weekly`, `monthly`, etc.).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  Current operational status of the fleet.

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

<ResponseField name="total_drivers" type="integer">
  Number of drivers currently assigned to this fleet.
</ResponseField>

<ResponseField name="total_vehicles" type="integer">
  Number of vehicles currently assigned to this fleet.
</ResponseField>

## More attributes

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

<ResponseField name="address" type="object">
  Physical address associated with the fleet's headquarters or billing location.

  <Expandable title="properties">
    <ResponseField name="city" type="string">
      City, district, or town.
    </ResponseField>

    <ResponseField name="country" type="string">
      Two-letter ISO country code.
    </ResponseField>

    <ResponseField name="line1" type="string">
      First line of the street address.
    </ResponseField>

    <ResponseField name="line2" type="string">
      Second line of the address.
    </ResponseField>

    <ResponseField name="postal_code" type="string">
      ZIP or postal code.
    </ResponseField>

    <ResponseField name="state" type="string">
      State, province, or region.
    </ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseField name="description" type="string | null">
  Optional description for the fleet.
</ResponseField>

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

<ResponseField name="metric_system" type="string">
  Unit system preferred for reports and distance/energy formats.

  Available options: `international_system`, `us_customary_system`, `imperial_system`
</ResponseField>

<ResponseField name="phone" type="string | null">
  Optional phone number associated with the fleet.
</ResponseField>

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

<ResponseField name="timezone" type="string">
  IANA timezone identifier used for reporting and scheduling.
</ResponseField>

<ResponseField name="total_energy_consumed_kwh" type="number">
  Total historical energy consumed by the fleet across all sessions (in kWh).
</ResponseField>

<ResponseField name="total_sessions" type="integer">
  Total number of charging sessions completed by the fleet.
</ResponseField>

<ResponseField name="updated" type="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`.
</ResponseField>

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