---
title: "Lookup Account"
method: POST
path: "/api/v1/accounts/lookup"
tags: ["Accounts"]
---

# Lookup Account

`POST /api/v1/accounts/lookup`

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.

## Headers

- `x-api-key` string, nullable
- `League` string, nullable

## Request body

- GLAccountLookupRequest — Request schema for account lookup (POST /api/v1/accounts/lookup).
  - `email` string, required — End user's email — Glory League's lookup handle for the account. Matched case-insensitively.
  - `org_id` string, nullable — Account uuid, when Glory League minted one themselves. Ignored if the email already resolves to an existing account.
  - `jwt` string, nullable — Short-lived token Glory League issued for this user; stored for reference when the account is first created.

## Response `200`

Successful Response

- GLAccountResponse — An account's identity + credit balance.
  - `org_id` string, required — Account uuid — send this as org_id on POST /videos
  - `org_name` string, required — The account's email handle
  - `video_quota` integer, required — Credits ever granted to this account
  - `video_usage` integer, required — Credits already spent
  - `remaining` integer, required — Credits left (never negative)
  - `can_upload` boolean, required — False means the next POST /videos returns 402 — send the user to the purchase page first

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.net/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/versions/c5f6b8674011/schema)