---
title: "What has this run already done?"
method: GET
path: "/v1/runs/{runId}"
tags: ["Effects"]
---

# What has this run already done?

`GET /v1/runs/{runId}`

## Request

- Base URL: `https://ratchetgate.com`
- URL: `https://ratchetgate.com/v1/runs/{runId}`
- Auth: HTTP bearer

A compact digest of every effect gated under one run id, grouped by what the caller must do about it. Built for an agent resuming work after a restart or a compacted context: it answers "what have I already done" in about a seventeenth of the bytes of listing the same effects, because a memory that costs more than re-deriving the answer does not get used. Actions with an unknown outcome are separated out, because they are the only ones that can hurt you.

## Path parameters

- `runId` string, required

## Response `200`

Default Response

- object

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Insufficient prepaid credit.
- `403`: Scope, policy, or budget refusal.
- `404`: Not found.
- `409`: Conflicting state or idempotency-key reuse.
- `413`: Payload too large.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/ratchetgate/apis/ratchet-api.md) · [All operations](https://skmtc.dev/ratchetgate/apis/ratchet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ratchetgate/apis/ratchet-api/revisions/5712f33c692f?raw)