---
title: "Get session by UUID"
method: GET
path: "/v1/claude/session/{uuid}"
tags: ["claude"]
---

# Get session by UUID

`GET /v1/claude/session/{uuid}`

Returns complete session data including all messages for a specific session UUID

## Path parameters

- `uuid` string, required

## Response `200`

OK

- GithubComVanpeltCatnipInternalModelsFullSessionData — Complete session data with all messages and metadata
  - `allSessions` GithubComVanpeltCatnipInternalModelsSessionListEntry[] — All sessions available for this workspace
    - `endTime` string — When the session ended (if available)
    - `isActive` boolean — Whether this session is currently active
    - `lastModified` string — When the session was last modified
    - `sessionId` string — Unique session identifier
    - `startTime` string — When the session started (if available)
  - `latestMessage` string — Latest assistant message text (always populated when available)
  - `latestSessionTitle` string — Latest session title (from PTY escape sequences or session history)
  - `latestThought` string — Latest thinking/reasoning content (always populated when available)
  - `latestUserPrompt` string — Latest user prompt from history (always populated when available)
  - `messageCount` integer — Total message count in full data
  - `messages` GithubComVanpeltCatnipInternalModelsClaudeSessionMessage[] — Full conversation history (only when full=true)
    - `agentId` string
    - `content` string — Content for system messages
    - `cwd` string
    - `isMeta` boolean
    - `isSidechain` boolean
    - `message` object
    - `parentUuid` string
    - `sessionId` string
    - `subtype` string — Subtype for system messages (e.g., "compact_boundary")
    - `summary` string — Summary text for summary-type messages
    - `timestamp` string
    - `type` string
    - `userType` string
    - `uuid` string
    - `version` string
  - `sessionInfo` GithubComVanpeltCatnipInternalModelsClaudeSessionSummary — Claude Code session summary with metrics and timing information
    - `allSessions` GithubComVanpeltCatnipInternalModelsSessionListEntry[] — List of all available sessions for this worktree
      - `endTime` string — When the session ended (if available)
      - `isActive` boolean — Whether this session is currently active
      - `lastModified` string — When the session was last modified
      - `sessionId` string — Unique session identifier
      - `startTime` string — When the session started (if available)
    - `currentSessionId` string — ID of the currently active session
    - `header` string — Header/title of the session from the Claude history
    - `isActive` boolean — Whether this session is currently active
    - `lastCost` number — Metrics (from completed sessions) Cost in USD of the last completed session
    - `lastDuration` integer — Duration in seconds of the last session
    - `lastSessionId` string — ID of the most recent completed session
    - `lastTotalInputTokens` integer — Total input tokens used in the last session
    - `lastTotalOutputTokens` integer — Total output tokens generated in the last session
    - `sessionEndTime` string — When the last session ended (if not active)
    - `sessionStartTime` string — When the current session started
    - `turnCount` integer — Number of conversation turns in the session
    - `worktreePath` string — Path to the worktree directory
  - `stats` GithubComVanpeltCatnipInternalModelsSessionStats — Session statistics including token counts and activity metrics
    - `activeDurationSeconds` number — Active duration in seconds (time Claude was actually working)
    - `activeToolNames` object — Tool usage counts by name
    - `apiCallCount` integer — Number of API calls made
    - `assistantMessages` integer — Number of assistant messages
    - `cacheCreationTokens` integer — Cache creation tokens
    - `cacheReadTokens` integer — Cache read tokens (context reuse)
    - `compactionCount` integer — Number of context compactions
    - `humanPromptCount` integer — Number of human prompts (user messages with text, not tool results)
    - `imageCount` integer — Number of images in the conversation
    - `lastContextSizeTokens` integer — Last message's cache_read value (actual context size in tokens)
    - `sessionDurationSeconds` number — Session duration in seconds (wall-clock time)
    - `subAgentCount` integer — Number of sub-agents spawned
    - `thinkingBlockCount` integer — Number of thinking blocks
    - `toolCallCount` integer — Total tool calls made
    - `totalInputTokens` integer — Total input tokens used
    - `totalMessages` integer — Total number of messages in the session
    - `totalOutputTokens` integer — Total output tokens generated
    - `userMessages` integer — Number of user messages
  - `todos` GithubComVanpeltCatnipInternalModelsTodo[] — Current todo items from the session
    - `content` string — The content/description of the todo
    - `id` string — Unique identifier for the todo item
    - `priority` 'high' | 'medium' | 'low' — Priority level of the todo
    - `status` 'pending' | 'in_progress' | 'completed' — Current status of the todo
  - `userPrompts` GithubComVanpeltCatnipInternalModelsClaudeHistoryEntry[] — User prompts from ~/.claude.json (only when full=true)
    - `display` string
    - `pastedContents` object

---

[API](https://skmtc.net/wandb/apis/catnip-container-api.md) · [All operations](https://skmtc.net/wandb/apis/catnip-container-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandb/catnip-container-api/versions/a075b0fa501a/schema)