v2

latestOpenAPI 3.1.02026-08-0810576180.4 KB

Accounts

Lookup Account

Resolve an email to its account uuid, creating the account 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.

Send org_id too if you minted the uuid on your side; it is used only when the email is new, so an email we already know keeps its existing uuid and its credits.

post/api/v1/accounts/lookup

Headers

x-api-keystring nullable

Leaguestring nullable

Request body

emailstring required

End user's email — Glory League's lookup handle for the account. Matched case-insensitively.

org_idstring nullable

Account uuid, when Glory League minted one themselves. Ignored if the email already resolves to an existing account.

jwtstring nullable

Short-lived token Glory League issued for this user; stored for reference when the account is first created.

Response

Successful Response

org_idstring required

Account uuid — send this as org_id on POST /videos

org_namestring required

The account's email handle

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