Ledger

List ledger entries

The audit chain, oldest first, as a resumable stream. Because the ledger is append-only and ascending by seq, a stored page.nextCursor is a watermark: a request from it never returns an entry before it. Persist the last non-null nextCursor only after processing every entry in the responses read, and resume from it; the last page, which had no cursor of its own, is returned again, so de-duplicate on seq.

seq is monotonic within a workspace but not gap-free; continuity is proven by the hash chain, not by seq.

get/api/v1/ledger

Request

  • Base URL: https://www.vestiarion.xyz
  • URL: https://www.vestiarion.xyz/api/v1/ledger
  • Auth: HTTP bearer

Query parameters

limitinteger

How many items to return. Defaults to 50; a larger value is capped at 200.

cursorstring

The previous response's page.nextCursor, passed back unchanged to continue. Opaque: never decode or construct one. A cursor this endpoint could not have issued is refused with 400.

domainstring

Only entries in this domain.

actorstring

Only entries written by this actor.

Response

OK

Changes

No recorded changes to this operation across all 2 revisions of this API.