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 gain 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; the three gems are reward assets (rubies from correct positions, sapphires from opinions, emeralds from invites).

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
sapphires
string
required
emeralds
string
required
created_at
string<date-time>
required