---
title: "List sessions for a repo"
method: GET
path: "/api/v1/cache/{org}/{repo}/sessions"
tags: ["Sessions"]
---

# List sessions for a repo

`GET /api/v1/cache/{org}/{repo}/sessions`

Returns the authoritative session list for a repo from entire-api.

## Path parameters

- `org` string, required
- `repo` string, required

## Query parameters

- `provider` 'gh' | 'et'
- `scope` 'all'
- `branch` string
- `search` string
- `authorFacet` string
- `authorFacetNot` string
- `agent` string
- `agentNot` string
- `model` string
- `modelNot` string
- `isReview` boolean
- `includeFacets` boolean
- `cursor` string
- `limit` integer

## Response `200`

Sessions list

- object
  - `sessions` object[], required
    - `sessionId` string, required
    - `displayName` string, required
    - `customName` string, nullable, required
    - `isPublic` boolean, required
    - `agent` string, nullable, required
    - `model` string, nullable, required
    - `kind` 'agent_review', nullable, required
    - `prompt` string, nullable, required
    - `firstCommitAuthorUsername` string, nullable, required
    - `startedAt` string, required
    - `lastActivityAt` string, required
    - `checkpointCount` number, required
    - `stepCount` number, required
    - `inputTokens` number, nullable, required
    - `outputTokens` number, nullable, required
    - `cacheCreationTokens` number, nullable, required
    - `cacheReadTokens` number, nullable, required
    - `attributionAgentLines` number, nullable, required
    - `attributionHumanAdded` number, nullable, required
    - `attributionHumanModified` number, nullable, required
    - `attributionHumanRemoved` number, nullable, required
    - `attributionTotalCommitted` number, nullable, required
    - `attributionCalculatedAt` string, nullable, required
  - `facets` object
    - `authors` object[], required
      - `value` string, required
      - `label` string, required
    - `agents` string[], required
    - `models` string[], required
  - `next_cursor` string, nullable, required
  - `repo_full_name` string, required
  - `app_has_access` boolean, nullable, required
  - `session_branch_exists` boolean, nullable, required
  - `history_status` 'pending' | 'syncing' | 'complete' | 'error', nullable, required
  - `history_complete` boolean, required
  - `source` 'db', required

## Other responses

- `400` — Invalid branch or cursor
- `403` — Checkpoint repo access denied — the source repo is public but its checkpoints live in a separate private repo the caller can't read.
- `404` — Repository not found

---

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