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}

Request

org_idstring required

x-api-keystring required

Required API key issued by Preciser.

Leaguestring required

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

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.

Aug 27, 20269b0abde08b06 Revision changes
- breaking
  the header request parameter League became required
- breaking
  the header request parameter x-api-key became required
- breaking
  header request parameter League list-of-types was narrowed by removing types null
- breaking
  header request parameter x-api-key list-of-types was narrowed by removing types null
- info
  for the header request parameter League, the type was generalized from no type to string
- info
  for the header request parameter x-api-key, the type was generalized from no type to string
Aug 26, 2026edd51549cfb6 Revision changes
- info
  added the optional property to the response with the status