Skip to main content
GET
List the key owner's ruby ledger

Authorizations

Authorization
string
header
required

Personal API key issued per SeeSaw user account: Authorization: Bearer sspat_…. Manage keys on the app API (/v1/users/me/api-keys). Revocation propagates within ~60 seconds (validation cache window).

The key's scopes decide what it may do: every key has read; a key created with ["read","write"] may also use the six write operations (marked x-required-scope: write in this document). Scopes are fixed at creation — to get write access, create a new key. A read-only key calling a write operation gets 403 FORBIDDEN_SCOPE.

Query Parameters

flow
enum<string>
default:all

in = rubies received, out = rubies taken back.

Available options:
all,
in,
out
source
enum<string>

Optional business-line filter (omit for all). other matches only the registered other types (today sapphire_conversion); rows of unregistered types appear only when unfiltered. An unknown value is 400 INVALID_ARGUMENT with details.field = source.

Available options:
settlement,
sell,
opinion_payback,
other
cursor
string

Opaque pagination cursor from a previous response's next_cursor.

limit
integer
default:20

Page size (max 100).

Required range: 1 <= x <= 100

Response

Ruby ledger entries

Uniform list shape. next_cursor is null on the last page.

data
object[]
required
next_cursor
string | null
required
has_more
boolean
required