Skip to main content
GET
/
v1
/
reports
/
ledger-summary
Get ledger summary
curl --request GET \
  --url https://api.scrip.dev/v1/reports/ledger-summary \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "asset_id": "550e8400-e29b-41d4-a716-446655440000",
      "asset_name": "Loyalty Points",
      "asset_symbol": "POINTS",
      "current_balance": "625000.00",
      "participant_count": 15420,
      "total_expired": "5000.00",
      "total_forfeited": "20000.00",
      "total_issued": "1500000.00",
      "total_redeemed": "850000.00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YWJjMTIz"
  }
}
Returns aggregated balances and flows for each asset in your ledger. The response includes total_issued, total_redeemed, total_expired, total_forfeited, current_balance, and participant_count per asset. Pass program_id to scope the summary to a single program. Omit it to get org-wide totals across all programs. All values are computed in real time from the ledger, so they reflect the current state without any delay.
For usage patterns and examples, see the Reporting guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Query Parameters

​
program_id
string<uuid>

Filter by program ID

Response

Ledger summaries

Ledger summary results

​
data
object[]

Per-asset ledger summaries

​
pagination
object

Pagination metadata for list responses