---
title: "Get session details"
method: GET
path: "/agents/{agentName}/sessions/{sessionId}"
---

# Get session details

`GET /agents/{agentName}/sessions/{sessionId}`

Retrieves detailed information about a specific session, including resource metrics and meeting IDs.

## Path parameters

- `agentName` string, required
- `sessionId` string, uuid, required

## Response `200`

Session details retrieved successfully

- SessionResponse
  - `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, nullable — Timestamp when the session ended
  - `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
  - `resourceMetrics` object, nullable — Resource usage metrics for the session, if available
    - `id` string — ID of the metrics record
    - `sessionId` string — ID of the session these metrics belong to
    - `sampleCount` integer — Number of metric samples collected
    - `cpuMillicoresP50` integer — CPU usage at the 50th percentile (in millicores)
    - `cpuMillicoresP90` integer — CPU usage at the 90th percentile (in millicores)
    - `cpuMillicoresP95` integer — CPU usage at the 95th percentile (in millicores)
    - `cpuMillicoresP99` integer — CPU usage at the 99th percentile (in millicores)
    - `memoryBytesP50` integer — Memory usage at the 50th percentile (in bytes)
    - `memoryBytesP90` integer — Memory usage at the 90th percentile (in bytes)
    - `memoryBytesP95` integer — Memory usage at the 95th percentile (in bytes)
    - `memoryBytesP99` integer — Memory usage at the 99th percentile (in bytes)
    - `timeseries` object[] — Time-series data of resource usage
      - `t` integer — Unix timestamp (seconds)
      - `c` integer — CPU usage (millicores)
      - `m` integer — Memory usage (bytes)
    - `eventTs` string, date-time — Timestamp of the most recent metrics event
    - `createdAt` string, date-time — Timestamp when the metrics record was created
  - `meetingIds` object[] — Daily meeting IDs associated with this session
    - `participantId` string — Daily participant ID
    - `meetingId` string — Daily meeting ID

## Other responses

- `401` — Invalid or missing API key
- `404` — Agent or session 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)