---
title: "Token accounting attempts page"
method: GET
path: "/v1/token-accounting/attempts"
tags: ["System"]
---

# Token accounting attempts page

`GET /v1/token-accounting/attempts`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/token-accounting/attempts`
- Auth: HTTP bearer

The latest committed revision of each attempt in a session, oldest first. `nextCursor` is opaque and null on the last page; a cursor from another session is refused.

## Query parameters

- `session_id` string, required
- `cursor` string
- `limit` integer
- `since_revision` integer

## Response `200`

Attempt page

- TokenAttemptPage
  - `storeId` string, nullable
  - `health` TokenLedgerHealth, required: Store-wide accounting health (shared contract shared/types/contracts/token-accounting.ts). `degraded` means a write failed and observations are held in memory; `unavailable` means the store could not be opened.
    - `state` 'available' | 'degraded' | 'unavailable', required
    - `fault` 'busy' | 'diskFull' | 'permissionDenied' | 'corrupt' | 'migrationFailed' | 'ownedByAnotherProcess' | 'ioError', nullable
    - `nonDurableObservations` integer, required
    - `suppressedObservations` integer, required
    - `quarantinedAttempts` integer, required
    - `unresolvedAttempts` integer, required
    - `oldestUnresolvedAt` string, date-time, nullable
  - `ledgerRevision` integer, required
  - `attempts` TokenObservation[], required
    - `identity` object, required
    - `revision` integer, required
    - `state` 'dispatchIntent' | 'inFlight' | 'partial' | 'final' | 'unresolved' | 'quarantined', required
    - `evidence` object, required
    - `counts` TokenCount[], required
      - `quantity` string, required
      - `category` string, required
      - `relation` 'inclusiveTotal' | 'subset' | 'disjoint', required
      - `derived` boolean, required
      - `value` integer, nullable
      - `contractRef` object, nullable
    - `observedAt` string, date-time, required
  - `nextCursor` string, nullable

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)