---
title: "Read the caller's Scout credit balance and recent ledger"
method: GET
path: "/api/account/scout-credits"
tags: ["Scout Credits"]
---

# Read the caller's Scout credit balance and recent ledger

`GET /api/account/scout-credits`

## Request

- Base URL: `https://flint.network`
- URL: `https://flint.network/api/account/scout-credits`
- Auth: one of:
  - API key in cookie `flint_session`
  - HTTP bearer

Returns the current Scout credit balance, lifetime purchased and used totals, and the last 20 ledger entries (topup, debit, refund) for the authenticated account.

## Response `200`

Balance and ledger.

- ScoutCreditsBalanceResponse
  - `ok` boolean, required
  - `balance` integer, required
  - `purchased_total` integer, required
  - `used_total` integer, required
  - `ledger` ScoutCreditLedgerEntry[], required
    - `at` string, date-time, required
    - `kind` 'topup' | 'debit' | 'refund', required
    - `amount` integer, required
    - `receipt_id` string, nullable
    - `record_id` string, nullable
    - `note` string, nullable

## Other responses

- `401`: No WorkOSOwnerSession cookie or bearerAgentSession token was presented.

---

[API](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api.md) · [All operations](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/revisions/eb5052b7b5dc?raw)