# The Session object

### The Session object

```json
{
  "id": "fcsess_1MwtnGLkdIwHu7ixs7NPQ7dq",
  "object": "financial_connections.session",
  "account_holder": {
    "customer": "cus_NiKSWdaFz2F6I0",
    "type": "customer"
  },
  "accounts": {
    "object": "list",
    "data": [],
    "has_more": false,
    "total_count": 0,
    "url": "/v1/financial_connections/accounts"
  },
  "client_secret": "fcsess_client_secret_KRJTKvCY3IKoYTrW18EazcO3",
  "filters": {
    "countries": [
      "US"
    ]
  },
  "livemode": false,
  "permissions": [
    "balances",
    "payment_method"
  ]
}
```

## 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/sessions/object.md?query=account_holder) (object, nullable)
  The account holder for whom accounts are collected in this session.

- [`accounts`](https://docs.stripe.com/api/financial_connections/sessions/object.md?query=accounts) (object)
  The accounts that were collected as part of this Session.

- [`bank_account_token`](https://docs.stripe.com/api/financial_connections/sessions/object.md?query=bank_account_token) (object, nullable)
  Information about the account if the user chose to enter details manually.

- `client_secret` (string, nullable)
  A value that will be passed to the client to launch the authentication flow.

- [`filters`](https://docs.stripe.com/api/financial_connections/sessions/object.md?query=filters) (object, nullable)
  Filters applied to this session that restrict the kinds of accounts to collect.

- [`limits`](https://docs.stripe.com/api/financial_connections/sessions/object.md?query=limits) (object, nullable)
  Settings for configuring Session-specific limits.

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

- [`manual_entry`](https://docs.stripe.com/api/financial_connections/sessions/object.md?query=manual_entry) (object, nullable)
  Settings for configuring manual entry of account details for this Session.

- `permissions` (array of enums)
  Permissions requested for accounts collected during this session.
Possible enum values:
  - `balances`
    Requests access for balance data on accounts collected in this session.

  - `ownership`
    Requests access for ownership data on accounts collected in this session.

  - `payment_method`
    Requests permission for the creation of a payment method from an account collected in this session.

  - `transactions`
    Requests access for transaction data on accounts collected in this session.

- `prefetch` (array of enums, nullable)
  Data features requested to be retrieved upon account creation.
Possible enum values:
  - `balances`
    Requests to prefetch balance data on accounts collected in this session.

  - `ownership`
    Requests to prefetch ownership data on accounts collected in this session.

  - `transactions`
    Requests to prefetch transaction data on accounts collected in this session.

- `return_url` (string, nullable)
  For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.