---
title: "Read the caller's locker-singularity idle ledger"
method: GET
path: "/api/v1/engage/games/locker-singularity/ledger"
tags: ["Games", "Game Engine", "Engage"]
---

# Read the caller's locker-singularity idle ledger

`GET /api/v1/engage/games/locker-singularity/ledger`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/engage/games/locker-singularity/ledger`
- Auth: HTTP bearer

First-ever read creates the ledger row. Otherwise credits offline accrual from the server lastSeenAt only (8h cap at 50% efficiency; client timestamps are never accepted) and returns { ledger, accruedBuzz, cappedHours, lastSeenAt }. Toy currencies only: zero writes to DSC balances, Rep, PointsHistory, pack inventory, or marketplace state (d-sports-api#682). The locker-singularity Game row ships as LIVE: the catalog marks it playable=true. Ledger routes serve COMING_SOON rows normally; an absent Game row returns 404 GAME_UNKNOWN with the ledger untouched. Optional X-Client-Version is checked against minClientVersion; below-minimum returns 403 GAME_UPDATE_REQUIRED. Native mirror: locker-singularity spec on the native soft-idle-mini-game branch.

## Headers

- `X-Client-Version` string

## Response `200`

{ ledger, accruedBuzz, cappedHours, lastSeenAt }

- object
  - `ledger` LedgerState, required: locker-singularity idle ledger wire state. Buzz counters are BigInt serialized as decimal strings. Additive-only wire evolution (d-sports-api#682).
    - `buzz` string, required: BigInt serialized as decimal string.
    - `lifetimeBuzz` string, required: BigInt serialized as decimal string.
    - `cumulativeBuzz` string, required: BigInt serialized as decimal string.
    - `playbooks` integer, required
    - `generators` IdleLedgerGeneratorState[], required
      - `generatorId` 'rookie-card' | 'foam-finger-stand' | 'zamboni-fleet' | 'banner-press', required
      - `owned` integer, required
    - `milestonesClaimed` string[], required
    - `upgrades` string[], required
    - `rings` integer, required: Most recent prestige grant (informational); totalRings is the cumulative balance.
    - `totalRings` integer, required
    - `prestigeCount` integer, required
    - `multiplier` number, required
    - `prestigeUnlocked` boolean, required
    - `version` integer, required
    - `lastSeenAt` string, date-time, required
  - `accruedBuzz` string, required: BigInt serialized as decimal string.
  - `cappedHours` number, required
  - `lastSeenAt` string, date-time, required

## Other responses

- `401`: UNAUTHORIZED
- `403`: GAME_UPDATE_REQUIRED
- `404`: GAME_UNKNOWN

## Changes

- **2026-09-24** `01971acf764b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/engage/games/locker-singularity/ledger/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
