Skip to main content
GET
Get the key owner's profile and balances

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.

Response

The authenticated user

The authenticated key owner — the only user shape carrying balances. Coins are the 2.0 currency, spent on positions and backing. Rubies and emeralds are reward assets: rubies from correct positions (including any ruby boost), positions sold in the SeeSaw app, and opinion paybacks; emeralds from invites. sapphires is deprecated — see its field.

id
string<uuid>
required
handle
string | null
required
nickname
string
required
avatar_url
string | null
required
url
string
required
coin_balance
string
required

Decimal string, 4 places.

rubies
string
required

Ruby balance. Every movement is listed by GET /me/ruby-ledger.

sapphires
string
required
deprecated

Deprecated — removed in 3.0.0. Always "0.0000": sapphires were merged 1:1 into rubies, and opinions now pay rubies.

emeralds
string
required
created_at
string<date-time>
required