> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Client Session Object

> Learn how the client_session object restricts your users to their own devices using a custom user_identifier_key that scopes Seam API results.

## The client\_session Object

Represents a [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens). If you want to restrict your users' access to their own devices, use client sessions.

You create each client session with a custom `user_identifier_key`. Normally, the `user_identifier_key` is a user ID that your application provides.

When calling the Seam API from your backend using an API key, you can pass the `user_identifier_key` as a parameter to limit results to the associated client session. For example, `/devices/list?user_identifier_key=123` only returns devices associated with the client session created with the `user_identifier_key` `123`.

A client session has a token that you can use with the Seam JavaScript SDK to make requests from the client (browser) directly to the Seam API. The token restricts the user's access to only the devices that they own.

See also [Get Started with React](https://docs.seam.co/ui-components/overview/getting-started-with-seam-components/get-started-with-react-components-and-client-session-tokens).

<ResponseExample>
  ```json Client Session theme={null}
  {
    "client_session_id": "c2cbd177-1ace-414b-bb1e-9f129e4a05c1",
    "connect_webview_ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ],
    "connected_account_ids": [
      "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    ],
    "created_at": "2025-06-15T16:54:17.946309Z",
    "customer_id": "77eccc4e-c8bc-4c7d-b83c-cb853ed3bade",
    "device_count": 1,
    "expires_at": "2025-06-17T16:54:17.946309Z",
    "token": "seam_cst1891oqCmB_6dBwV8PJ2Fsoe9dWYVyMfVHq",
    "user_identifier_key": "user_id_1",
    "user_identity_id": "a6e93f84-565e-47d7-8908-1ca71ada373c",
    "user_identity_ids": [
      "a6e93f84-565e-47d7-8908-1ca71ada373c"
    ],
    "workspace_id": "b887bf84-9849-4454-a562-cf84293d9781"
  }
  ```
</ResponseExample>

***

## Properties

<ResponseField name="client_session_id" type="String (UUID)">
  ID of the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="connect_webview_ids" type="Array">
  IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="connected_account_ids" type="Array">
  IDs of the [connected accounts](https://docs.seam.co/core-concepts/connected-accounts) associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="created_at" type="String (ISO 8601)">
  Date and time at which the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens) was created.
</ResponseField>

<ResponseField name="customer_key" type="String">
  Customer key associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="device_count" type="number">
  Number of devices associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="expires_at" type="String (ISO 8601)">
  Date and time at which the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens) expires.
</ResponseField>

<ResponseField name="token" type="String">
  Client session token associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="user_identifier_key" type="String">
  Your user ID for the user associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>

<ResponseField name="user_identity_id" type="String (UUID)">
  ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with the client session.
</ResponseField>

<ResponseField name="user_identity_ids" type="Array" deprecated>
  IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with the client session.
</ResponseField>

<ResponseField name="workspace_id" type="String (UUID)">
  ID of the [workspace](https://docs.seam.co/core-concepts/workspaces) associated with the [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
</ResponseField>