Sign in

16e2b6a1c2bb

OpenAPI 3.1.02026-08-1210683187.5 KB
Accounts

Lookup Account

Resolve a user UUID to its credit wallet, creating it on first sight.

Get-or-create, so a brand-new user always has a uuid to submit with. A created account starts at zero credits — exactly the account POST /videos would have provisioned — so can_upload is false until credits are bought.

user_id is the canonical billing key. Email and org_id remain supported only as legacy lookup inputs.

post/api/v1/accounts/lookup

Headers

x-api-keystring nullable
Leaguestring nullable

Request body

OR
OR

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 already spent

remaininginteger required

Credits left (never negative)

can_uploadboolean required

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