---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions

`GET /v1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions`

## Request

- Base URL: `https://aiplatform.googleapis.com`
- URL: `https://aiplatform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists Sessions in a given reasoning engine.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `reasoningEnginesId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- GoogleCloudAiplatformV1ListSessionsResponse: Response message for SessionService.ListSessions.
  - `nextPageToken` string: A token, which can be sent as ListSessionsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.
  - `sessions` GoogleCloudAiplatformV1Session[]: A list of sessions matching the request.
    - `createTime` string, google-datetime: Output only. Timestamp when the session was created.
    - `displayName` string: Optional. The display name of the session.
    - `expireTime` string, google-datetime: Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input. The minimum value is 24 hours from the time of creation.
    - `labels` object: The labels with user-defined metadata to organize your Sessions. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.
    - `name` string: Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
    - `sessionState` object: Optional. Session specific memory which stores key conversation points.
    - `ttl` string, google-duration: Optional. Input only. The TTL for this session. The minimum value is 24 hours.
    - `updateTime` string, google-datetime: Output only. Timestamp when the session was updated.
    - `userId` string: Required. Immutable. String id provided by the user

---

[API](https://skmtc.dev/google/apis/aiplatform.md) - [All operations](https://skmtc.dev/google/apis/aiplatform/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/aiplatform/revisions/3aca3b348f0c?raw)