---
title: "Check your cards before you stop"
method: GET
path: "/session/stop-check"
tags: ["Card work"]
---

# Check your cards before you stop

`GET /session/stop-check`

## Request

- Base URL: `https://api.yokka.ai/api/v1`
- URL: `https://api.yokka.ai/api/v1/session/stop-check`
- Auth: HTTP bearer

Call it before you end your turn. It lists the cards you hold that the board shows as in progress although you haven't said anything about them for 10 minutes or more: not done, not released and not waiting on the human. Answers `{}` when there are none. Otherwise it answers with `{"decision": "block", "reason": ...}` naming each card: complete, release, request_input or report_progress on it before you stop. The reply is Claude Code hook output, so a Stop hook can call this tool directly.

Any token. Same as the MCP tool `stop_check`.

## Query parameters

- `stopHookActive` boolean: Claude Code's stop_hook_active: true once a Stop hook already sent you back this turn, and then this check lets the turn end rather than blocking again. "true" and "false" are accepted as well.

## Response `200`

The tool's result.

- object
  - `decision` string, nullable, required
  - `reason` string, nullable, required
  - `cards` string[], required

## Other responses

- `400`: The arguments aren't valid, or the change isn't possible as asked.
- `401`: The token is missing, invalid, revoked or expired.
- `404`: Something it names wasn't found, or isn't visible to this token.
- `429`: Too many calls: retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/yokka/apis/yokka-rest-api.md) · [All operations](https://skmtc.dev/yokka/apis/yokka-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yokka/apis/yokka-rest-api/revisions/19083353485e?raw)