---
title: "Retrieve Run Checkpoint"
method: GET
path: "/api/v1/runs/{id}/checkpoint"
tags: ["Run Internals"]
---

# Retrieve Run Checkpoint

`GET /api/v1/runs/{id}/checkpoint`

Returns the latest checkpoint data for a run, or null if no checkpoint has been recorded yet.

## Path parameters

- `id` string, required

## Response `200`

Checkpoint data (null if not yet available)

- RunCheckpoint — Serializable snapshot of execution state for crash recovery and resume.
  - `timestamp` string, date-time, required — ISO 8601 timestamp when the checkpoint was created.
  - `current_node` string, required — Identifier of the node being executed at checkpoint time.
  - `completed_nodes` string[], required — Identifiers of nodes that have completed execution.
  - `node_retries` object, required — Map of node identifier to retry count.
  - `context_values` object, required — Key-value context map accumulated during execution.
  - `node_outcomes` object — Map of node identifier to outcome data for goal gate checks after resume.
  - `next_node_id` string — The node to resume execution at after this checkpoint.
  - `git_commit_sha` string — SHA of the git commit created at this checkpoint.
  - `loop_failure_signatures` object — Failure signature counts within the main loop.
  - `restart_failure_signatures` object — Failure signature counts across loop_restart edges.

## Other responses

- `404` — Run not found

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/versions/bee030053823/schema)