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

<div className="xl:hidden">
  <CodeGroup>
    ```json The Account object theme={null}
    {
        "id": "acct_1Ys68AQSkEx2u9QejR24oCTB5Nck3veR",
        "object": "account",
        "billing_details": {
            "billing_address": {
                "city": "Paris",
                "country": "FR",
                "line1": "10 Rue de la Paix",
                "line2": "Batiment A",
                "postal_code": "75002",
                "state": "Ile-de-France"
            }
        },
        "business_type": null,
        "contact": {
            "email": "example@example.com",
            "name": "Example",
            "phone": "+33189000010"
        },
        "created": "2026-04-01T00:34:12.489Z",
        "default_currency": "eur",
        "description": null,
        "email": "example@example.com",
        "metadata": {},
        "metric_system": "metric",
        "name": "Example Account",
        "plan": "professional",
        "preferences": {
            "billing_cycle": "monthly",
            "default_currency": "eur",
            "default_payment_method": null,
            "notifications": true,
            "report_frequency": "weekly",
            "reporting_enabled": true
        },
        "registration_number": null,
        "status": "active",
        "type": "business",
        "updated": "2026-04-01T02:34:06.174Z",
        "wallet_balance": 42850
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Account object theme={null}
    {
        "id": "acct_1Ys68AQSkEx2u9QejR24oCTB5Nck3veR",
        "object": "account",
        "billing_details": {
            "billing_address": {
                "city": "Paris",
                "country": "FR",
                "line1": "10 Rue de la Paix",
                "line2": "Batiment A",
                "postal_code": "75002",
                "state": "Ile-de-France"
            }
        },
        "business_type": null,
        "contact": {
            "email": "example@example.com",
            "name": "Example",
            "phone": "+33189000010"
        },
        "created": "2026-04-01T00:34:12.489Z",
        "default_currency": "eur",
        "description": null,
        "email": "example@example.com",
        "metadata": {},
        "metric_system": "metric",
        "name": "Example Account",
        "plan": "professional",
        "preferences": {
            "billing_cycle": "monthly",
            "default_currency": "eur",
            "default_payment_method": null,
            "notifications": true,
            "report_frequency": "weekly",
            "reporting_enabled": true
        },
        "registration_number": null,
        "status": "active",
        "type": "business",
        "updated": "2026-04-01T02:34:06.174Z",
        "wallet_balance": 42850
    }
    ```
  </ResponseExample>
</div>

This object represents an account in Charge. Use it to manage drivers, vehicles, payment methods, charging activity, invoices, and reports under one business entity.

## Attributes

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

<ResponseField name="default_currency" type="string">
  Three-letter ISO currency code for default billing and pricing.
</ResponseField>

<ResponseField name="email" type="string | null">
  Email address associated with the account (may duplicate contact.email).
</ResponseField>

<ResponseField name="name" type="string | null">
  Display name or registered name of the account.
</ResponseField>

<ResponseField name="plan" type="string">
  Subscription or feature plan assigned to the account.
</ResponseField>

<ResponseField name="preferences" type="object">
  Settings for billing, notifications, and reporting.

  <Expandable title="properties">
    <ResponseField name="billing_cycle" type="string">
      Billing cycle preference (`monthly`, `weekly`, etc.).
    </ResponseField>

    <ResponseField name="default_currency" type="string">
      Preferred default currency code.
    </ResponseField>

    <ResponseField name="default_payment_method" type="string | null" 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 used for billing.
    </ResponseField>

    <ResponseField name="notifications" type="boolean">
      Whether the account receives charging session notifications.
    </ResponseField>

    <ResponseField name="report_frequency" type="string">
      Frequency of scheduled reports.
    </ResponseField>

    <ResponseField name="reporting_enabled" type="boolean">
      Whether reporting is enabled for the account.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="type" type="string">
  Type of account.
</ResponseField>

## More attributes

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

<ResponseField name="billing_details" type="object">
  Billing information used for invoicing and reports.

  <Expandable title="properties">
    <ResponseField name="billing_address" type="object">
      Physical address used for billing purposes.

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

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

        <ResponseField name="line1" type="string">
          First line of the 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, county, province, or region.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="business_type" type="string | null">
  Type of legal entity associated with the account.
</ResponseField>

<ResponseField name="contact" type="object">
  Primary contact person for the account.

  <Expandable title="properties">
    <ResponseField name="email" type="string">
      Contact email address.
    </ResponseField>

    <ResponseField name="name" type="string">
      Full name of the contact person.
    </ResponseField>

    <ResponseField name="phone" type="string">
      Phone number for contact.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the account 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 or label for the account.
</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 | null">
  Preferred measurement system.
</ResponseField>

<ResponseField name="registration_number" type="string | null">
  Government-issued registration number (for businesses).
</ResponseField>

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

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

<ResponseField name="updated" type="string">
  Time at which the account 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">
  Current account wallet balance in the smallest currency unit.
</ResponseField>