List balance ledger

Returns the store’s balance ledger, an immutable record of every balance mutation. Requires the PAYOUTS_READ scope.

GET https://api.pandabase.io/v2/core/stores/{storeId}/payouts/ledger

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

Query parameters

page integer default: 1

(range 1–∞, defaults to 1)

limit integer default: 25

(range 1–100, defaults to 25)

type enum

No description.

Header parameters

idempotency-key string

(length 8–32)

Response 200

Default Response

ok enum required

(one of true)

data object required

No description.

Request
curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/payouts/ledger
Response
{  "ok": true,  "data": {    "items": [      {        "id": "ble_8q1mzj0kxw5h7n4tr3bcfp2v",        "type": "PAYMENT_RECEIVED",        "amount": 2553,        "runningBalance": 1141500,        "referenceId": "pmt_5h7n4tr3bcfp2v8q1mzj0kxw",        "description": "Payment received for order cs_abcdef0123456789",        "createdAt": "2026-05-14T12:35:10.000Z"      }    ],    "pagination": {      "page": 1,      "limit": 25,      "total": 1,      "totalPages": 1    }  }}