# The Account object

### The Account object

```json
{
  "id": "fca_1MwVK82eZvKYlo2Cjw8FMxXf",
  "object": "financial_connections.account",
  "account_holder": {
    "customer": "cus_9s6XI9OFIdpjIg",
    "type": "customer"
  },
  "balance": null,
  "balance_refresh": null,
  "category": "cash",
  "created": 1681412208,
  "display_name": "Sample Checking Account",
  "institution_name": "StripeBank",
  "last4": "6789",
  "livemode": false,
  "ownership": null,
  "ownership_refresh": null,
  "permissions": [],
  "status": "active",
  "subcategory": "checking",
  "subscriptions": [],
  "supported_payment_method_types": [
    "us_bank_account"
  ],
  "transaction_refresh": null
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- [`account_holder`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=account_holder) (object, nullable)
  The account holder that this account belongs to.

- [`account_numbers`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=account_numbers) (array of objects, nullable)
  Details about the account numbers.

- [`balance`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=balance) (object, nullable)
  The most recent information about the account’s balance.

- [`balance_refresh`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=balance_refresh) (object, nullable)
  The state of the most recent attempt to refresh the account balance.

- `category` (enum)
  The type of the account. Account category is further divided in `subcategory`.
Possible enum values:
  - `cash`
    The account represents real funds held by the institution (e.g. a checking or savings account).

  - `credit`
    The account represents credit extended by the institution (e.g. a credit card or mortgage).

  - `investment`
    The account represents investments, or any account where there are funds of unknown liquidity.

  - `other`
    The account does not fall under the other categories.

- `created` (timestamp)
  Time at which the object was created. Measured in seconds since the Unix epoch.

- `display_name` (string, nullable)
  A human-readable name that has been assigned to this account, either by the account holder or by the institution.

- `institution_name` (string)
  The name of the institution that holds this account.

- `last4` (string, nullable)
  The last 4 digits of the account number. If present, this will be 4 numeric characters.

- `livemode` (boolean)
  If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.

- `ownership` (string, nullable, expandable (can be expanded into an object with the `expand` request parameter))
  The most recent information about the account’s owners.

- [`ownership_refresh`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=ownership_refresh) (object, nullable)
  The state of the most recent attempt to refresh the account owners.

- `permissions` (array of enums, nullable)
  The list of permissions granted by this account.
Possible enum values:
  - `balances`
    Allows accessing balance data from the account.

  - `ownership`
    Allows accessing ownership data from the account.

  - `payment_method`
    Allows the creation of a payment method from the account.

  - `transactions`
    Allows accessing transactions data from the account.

- `status` (enum)
  The status of the link to the account.
Possible enum values:
  - `active`
    Stripe is able to retrieve data from the Account without issues.

  - `disconnected`
    Account connection has been terminated through the [disconnect API](https://docs.stripe.com/api/financial_connections/accounts/disconnect.md) or an [end user request](https://support.stripe.com/user/how-do-i-disconnect-my-linked-financial-account).

  - `inactive`
    Stripe cannot retrieve data from the Account.

- [`status_details`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=status_details) (object)
  Details on the status of the account.

- `subcategory` (enum)
  If `category` is `cash`, one of:

  - `checking`
  - `savings`
  - `other`

  If `category` is `credit`, one of:

  - `mortgage`
  - `line_of_credit`
  - `credit_card`
  - `other`

  If `category` is `investment` or `other`, this will be `other`.
Possible enum values:
  - `checking`
    The account is a checking account.

  - `credit_card`
    The account represents a credit card.

  - `line_of_credit`
    The account represents a line of credit.

  - `mortgage`
    The account represents a mortgage.

  - `other`
    The account does not fall under any of the other subcategories.

  - `savings`
    The account is a savings account.

- `subscriptions` (array of enums, nullable)
  The list of data refresh subscriptions requested on this account.
Possible enum values:
  - `transactions`
    Subscribes to periodic transactions data refreshes from the account.

- `supported_payment_method_types` (array of enums)
  The [PaymentMethod type](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-type)(s) that can be created from this account.
Possible enum values:
  - `link`
    A `link` PaymentMethod can be created.

  - `us_bank_account`
    A `us_bank_account` PaymentMethod can be created.

- [`transaction_refresh`](https://docs.stripe.com/api/financial_connections/accounts/object.md?query=transaction_refresh) (object, nullable)
  The state of the most recent attempt to refresh the account transactions.