---
title: "Get agent sessions"
method: GET
path: "/agents/{agentName}/sessions"
---

# Get agent sessions

`GET /agents/{agentName}/sessions`

Retrieves sessions for the specified agent with optional filtering and pagination.

## Path parameters

- `agentName` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `deploymentId` string
- `startTime` integer
- `endTime` integer
- `status` 'active' | 'ended' | 'all'
- `startType` 'cold' | 'warm' | 'all'
- `startTimeMin` integer
- `startTimeMax` integer

## Response `200`

Agent sessions retrieved successfully

- object
  - `total_count` integer — Total number of sessions matching the parameters
  - `sessions` object[] — List of sessions
    - `sessionId` string — ID of the session
    - `serviceId` string — ID of the service for this session
    - `organizationId` string — ID of the organization that this session is associated with
    - `deploymentId` string — ID of the deployment that this session is associated with
    - `endedAt` string, date-time — Timestamp when the log was generated
    - `botStartSeconds` integer, nullable — Number of seconds between bot start request and bot start
    - `coldStart` boolean, nullable — Whether the bot start was a [cold start](/pipecat-cloud/fundamentals/scaling#cold-starts)
    - `completionStatus` string, nullable — The completion status of the session. This can be an http return code or a string like `HTTP_COMPLETED`, `HTTP_ERROR`, `WS_CONNECTION_CLOSED`, among others
    - `createdAt` string, date-time — Timestamp when the session was created
    - `updatedAt` string, date-time — Timestamp when the session was last updated

## Other responses

- `400` — Invalid query parameters
- `404` — Agent not found
- `500` — Internal server error

---

[API](https://skmtc.dev/pipecat/apis/pipecat-cloud.md) · [All operations](https://skmtc.dev/pipecat/apis/pipecat-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipecat/pipecat-cloud/revisions/acd0f7dfe734/schema)