---
title: "Get Sessions Endpoint"
method: GET
path: "/sessions"
tags: ["Sessions"]
---

# Get Sessions Endpoint

`GET /sessions`

## Query parameters

- `start_time` integer, nullable — Filter sessions created after this Unix timestamp (in milliseconds).
- `end_time` integer, nullable — Filter sessions created before this Unix timestamp (in milliseconds).
- `session_id` string, nullable — Filter sessions by a specific session ID.
- `task_id` string, nullable — Filter sessions by a specific task ID.
- `page` integer, nullable — Page number for pagination.
- `limit` integer, nullable — Number of sessions per page (maximum 100).
- `executionType[]` string[], nullable — Filter sessions by execution type (e.g., 'default', 'deepsearch').
- `sort_by` 'timestamp' | 'executionTime' | 'taskId' | 'status' | 'executionType', nullable — Field to sort sessions by (e.g., 'timestamp', 'executionTime').
- `sort_order` 'ascend' | 'descend', nullable — Sort order ('ascend' or 'descend').
- `raccoon_passcode` string, nullable — Filter sessions by Raccoon passcode.

## Response `200`

Successful Response

- SessionListResponse
  - `sessions` Session[], required — List of sessions.
    - `sessionId` string, required — Unique identifier for the session.
    - `executionType` 'default' | 'deepsearch' | 'fleet', required — The type of execution performed (e.g., 'default', 'deepsearch').
    - `status` 'success' | 'failure' | 'running', required — Current status of the session.
    - `inputs` object, required — Input parameters used for the session.
    - `output` object[], required — Output generated by the session.
    - `raccoonPasscode` string, required — Passcode associated with the user.
    - `taskId` string, required — Unique identifier for the associated task.
    - `executionTime` integer, required — Time taken for the session execution (in milliseconds).
    - `timestamp` integer, required — Unix timestamp (in milliseconds) indicating when the session was created.
  - `meta` Meta, required
    - `totalPages` integer, required — Total number of pages available.
    - `totalRecords` integer, required — Total number of records across all pages.
    - `currentPage` integer, required — The current page number.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/raccoonaihq/apis/raccoon-ai-api.md) · [All operations](https://skmtc.net/raccoonaihq/apis/raccoon-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/raccoonaihq/raccoon-ai-api/revisions/cc64732da5aa/schema)