GETBearer token

List balance entries

/api/v1/balance/entries

Read up to 100 organization ledger entries. A direct-order receipt can have zero balance change, with paidAmount in info.

Request example

cURL

curl "https://tovahub.com/api/v1/balance/entries" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response

JSON

[]

No parameters.

HTTP status 200

Return an array of up to 100 recent organization ledger entries.

[]array

The root response is an array, sorted by createdAt descending.

[]._idstring (ObjectId)

Ledger entry identifier.

[].assetstring

Stored asset name; legacy asset names may remain.

[].amountstring

Signed integer amount in the stored asset's units.

[].reasonstring

Ledger reason.

[].linkstring

Stored reference; do not assume an HTTP URL.

[].createdAtstring (ISO 8601)

Entry creation time.

[].infounknown | null

Purpose-specific stored metadata; no universal nested contract is declared.