# Get one session

`GET /o/{org}/p/{project}/sessions/{session}`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `org` | path | string | yes | The org's slug or id. A caller with no role in the org gets `404`. |
| `project` | path | string | yes | A Project's handle (name) or id, resolved inside `{org}` — OR the reserved sentinel `_` meaning "no Project" (a direct-repo / repo-less dispatch on `POST`; "no Project constraint, resolve by session id alone" everywhere else). A real handle that doesn't match the session's actual Project is `404`.  |
| `session` | path | string | yes | The session's full id (`execution_id`). |

## Example request

```bash
curl "https://api.prix.dev/o/$RUSH_ORG/p/_/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $RUSH_API_KEY"
```

```typescript
const org = process.env.RUSH_ORG;
const sessionId = process.env.SESSION_ID;

const res = await fetch(`https://api.prix.dev/o/${org}/p/_/sessions/${sessionId}`, {
  headers: {
    Authorization: `Bearer ${process.env.RUSH_API_KEY}`,
  },
});

console.log(res.status, await res.json());
```

```python
import os

import requests

org = os.environ["RUSH_ORG"]
session_id = os.environ["SESSION_ID"]

res = requests.get(
    f"https://api.prix.dev/o/{org}/p/_/sessions/{session_id}",
    headers={"Authorization": f"Bearer {os.environ['RUSH_API_KEY']}"},
)

print(res.status_code, res.json())
```

## Responses

### 200

The session.

- `execution_id` (string, required)
- `kind` (string, required, one of `cloud`, `local`)
- `org_id` (string | null, optional)
- `project_id` (string | null, optional)
- `agent` (string | null, optional): The harness.
- `status` (string, required, one of `queued`, `allocating`, `running`, `paused`, `input_required`, `needs_review`, `completed`, `failed`, `cancelled`, `expired`): `paused` is a resumable session parked between turns; `needs_review` finished without the proof it was asked for.
- `persistence_mode` (string | null, optional, one of `ephemeral`, `resumable`, `null`)
- `machine_state` (string | null, optional): The sandbox's own lifecycle (preparing, running, pausing, paused, resuming…), separate from `status`.
- `sandbox_generation` (integer | null, optional): Increments on every resume.
- `prompt` (string | null, optional)
- `repo_owner` (string | null, optional)
- `repo_name` (string | null, optional)
- `branch` (string | null, optional)
- `pr_url` (string | null, optional)
- `summary` (string | null, optional)
- `error` (string | null, optional)
- `started_by` (object | null, optional)
  - `name` (string | null, optional)
  - `avatar_url` (string | null, optional)
- `input_tokens` (integer | null, optional)
- `output_tokens` (integer | null, optional)
- `cache_read_tokens` (integer | null, optional)
- `cache_write_tokens` (integer | null, optional)
- `total_tokens` (integer | null, optional): Uncached input plus cache writes plus output; null when the run reported none.
- `reasoning_tokens` (integer | null, optional)
- `total_cost_usd` (number | null, optional)
- `model` (string | null, optional)
- `tool_calls_count` (integer | null, optional)
- `tool_errors_count` (integer | null, optional)
- `turns_count` (integer | null, optional)
- `files_produced` (integer | null, optional)
- `attachments` (array of object, optional): Files the caller attached when starting the run.
  - `id` (string, required)
  - `name` (string, required)
  - `mime` (string, required)
  - `size` (integer, required)
  - `expired_at` (string | null, required)
- `artifacts` (array of ArtifactFile, optional): The first 6 artifacts; `artifact_count` has the total.
  - `name` (string, required)
  - `size` (integer, required): Bytes.
  - `content_type` (string, required)
- `artifact_count` (integer, optional)
- `harness_version_requested` (string | null, optional)
- `harness_version_resolved` (string | null, optional)
- `profile_id` (string | null, optional): The saved agent the run started from.
- `profile_revision` (integer | null, optional)
- `profile_digest` (string | null, optional)
- `requested_overrides` (object | null, optional)
  - `model` (string, optional)
  - `effort` (string, optional)
  - `speed` (string, optional)
- `agent_profile` (object | null, optional)
  - `id` (string, optional)
  - `name` (string, optional)
- `effective` (object | null, optional): What a saved-agent run actually ran with.
  - `model` (string | null, optional)
  - `effort` (string | null, optional)
  - `speed` (string | null, optional)
  - `harness_version` (string | null, optional)
  - `catalog_revision` (string | null, optional)
  - `image_digest` (string | null, optional)
- `snapshot` (object | null, optional): The saved-agent configuration the run was pinned to.
- `effective_config` (object | null, optional): What the sandbox loaded (harness version, plugins, hooks, commands), as the runtime reported it.
- `session_capture` (string | null, optional, one of `complete`, `partial`, `failed`, `null`)
- `created_at` (string, required)
- `updated_at` (string | null, optional)

### 401

No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.

### 404

No such resource for the caller, including one that exists in an org the caller cannot see.

## Example response (200)

```json
{
  "execution_id": "3f9c2a71d04b8e65",
  "kind": "cloud",
  "org_id": "0b6f3c52-8d1e-4a7b-9c55-2f1e8d7a6b90",
  "project_id": "7d2e9a14-5b3c-4f60-8e21-9a0b1c2d3e4f",
  "agent": "claude",
  "status": "completed",
  "persistence_mode": "resumable",
  "machine_state": "paused",
  "sandbox_generation": 1,
  "prompt": "Fix the flaky checkout test and open a PR.",
  "repo_owner": "acme",
  "repo_name": "web",
  "branch": "rush/fix-flaky-checkout",
  "pr_url": "https://github.com/acme/web/pull/412",
  "summary": "Pinned the clock in checkout.spec.ts and opened PR 412.",
  "error": null,
  "started_by": {
    "name": "Dana Lee",
    "avatar_url": null
  },
  "input_tokens": 182340,
  "output_tokens": 9120,
  "cache_read_tokens": 1204500,
  "cache_write_tokens": 40210,
  "total_tokens": 231670,
  "reasoning_tokens": 0,
  "total_cost_usd": 1.84,
  "model": "claude-opus-5-5",
  "tool_calls_count": 37,
  "tool_errors_count": 2,
  "turns_count": 1,
  "files_produced": 1,
  "attachments": [],
  "artifacts": [
    {
      "name": "coverage-report.html",
      "size": 48213,
      "content_type": "text/html"
    }
  ],
  "artifact_count": 1,
  "harness_version_requested": null,
  "harness_version_resolved": "2.1.291",
  "profile_id": null,
  "profile_revision": null,
  "profile_digest": null,
  "requested_overrides": null,
  "agent_profile": null,
  "effective": null,
  "snapshot": null,
  "effective_config": {
    "harness_version": "2.1.291"
  },
  "session_capture": "complete",
  "created_at": "2026-10-06T15:02:11.000Z",
  "updated_at": "2026-10-06T15:09:03.000Z"
}
```