---
title: "Get Task Progress"
method: GET
path: "/api/v1/tasks/{task_id}/progress"
---

# Get Task Progress

`GET /api/v1/tasks/{task_id}/progress`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/api/v1/tasks/{task_id}/progress`
- Auth: none declared

Return the chain-computed progress vector for a task.

The ledger read is resolved from the task's own authoritative run id, never
from a client-supplied parameter, so the vector cannot be steered by pairing
this task's journal with an arbitrary run's ledger.

## Path parameters

- `task_id` string, required

## Response `200`

Successful Response

- TaskProgressResponse: The chain-computed progress vector for a task (#2553). A pure projection of journaled work: checkpoints, diffs, gates, evidence producers, and ledger transitions. ``vector_hash`` is the stable hash of the canonical vector; two projections of the same run agree byte-for-byte.
  - `task_id` string, required
  - `schema_version` integer, required
  - `checkpoints` integer, required
  - `diffs_captured` integer, required
  - `gate_attempts` integer, required
  - `evidence_declared` integer, required
  - `evidence_passed` integer, required
  - `ledger_phase` string, required
  - `ledger_attempts` integer, required
  - `terminal` boolean, required
  - `earned_steps` integer, required
  - `phase_ordinal` integer, required
  - `vector_hash` string, required

## Other responses

- `404`: Task not found
- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)
