The Account object

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

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

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

string

Unique identifier for the object.

string

Three-letter ISO currency code for default billing and pricing.

string | null

Email address associated with the account (may duplicate contact.email).

string | null

Display name or registered name of the account.

string

Subscription or feature plan assigned to the account.

object

Settings for billing, notifications, and reporting.

Show properties

string

Billing cycle preference (monthly, weekly, etc.).

string

Preferred default currency code.

string | null

ID of the default payment method used for billing.

boolean

Whether the account receives charging session notifications.

string

Frequency of scheduled reports.

boolean

Whether reporting is enabled for the account.

string

Type of account.

More attributes

string

String representing the object’s type.

object

Billing information used for invoicing and reports.

Show properties

object

Physical address used for billing purposes.

Show properties

string

City, district, suburb, or town.

string

Two-letter ISO country code.

string

First line of the address.

string

Second line of the address.

string

ZIP or postal code.

string

State, county, province, or region.

string | null

Type of legal entity associated with the account.

object

Primary contact person for the account.

Show properties

string

Contact email address.

string

Full name of the contact person.

string

Phone number for contact.

string

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

string | null

Optional description or label for the account.

object

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

string | null

Preferred measurement system.

string | null

Government-issued registration number (for businesses).

string

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

string

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

integer

Current account wallet balance in the smallest currency unit.

Getting Started

API Behavior

API Reference

The Account object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes