Accounts

Get Account

Read a user's credit balance by UUID (legacy path name: org_id).

Read-only on purpose: an unknown uuid is a 404 rather than a new account, so a typo cannot mint wallets. Use POST /accounts/lookup to create one.

get/api/v1/accounts/{org_id}

Path parameters

org_idstring required

Headers

x-api-keystring required

Required API key issued by Preciser.

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Required tenant/database selector, for example pitchbio-master.

Response

Successful Response

user_idstring required

User UUID — send this as user_id on POST /videos and in the JWT

org_idstring nullable

Deprecated wallet-id alias retained for legacy clients

org_namestring required

Legacy account handle; normally blank for user-id wallets

video_quotainteger required

Credits ever granted to this account

video_usageinteger required

Credits finalized and already spent

video_reservedinteger required

Credits temporarily held by videos awaiting game info; these are not spent yet but are unavailable to another concurrent upload

remaininginteger required

Unspent and unreserved credits left (never negative)

can_uploadboolean required

False means the next POST /videos returns payment_required — send the user to the purchase page first

return_urlstring nullable

HTTPS return URL bound to the requested user and video UUID, if one was supplied with POST /videos.

Changes