---
title: "Get Account"
method: GET
path: "/api/v1/accounts/{org_id}"
tags: ["Accounts"]
---

# Get Account

`GET /api/v1/accounts/{org_id}`

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.

## Path parameters

- `org_id` string, required

## Headers

- `x-api-key` string, required — Required API key issued by Preciser.
- `League` string, required — Required tenant/database selector, for example pitchbio-master.

## Response `200`

Successful Response

- GLAccountResponse — An account's identity + credit balance.
  - `user_id` string, required — User UUID — send this as user_id on POST /videos and in the JWT
  - `org_id` string, nullable — Deprecated wallet-id alias retained for legacy clients
  - `org_name` string, required — Legacy account handle; normally blank for user-id wallets
  - `video_quota` integer, required — Credits ever granted to this account
  - `video_usage` integer, required — Credits finalized and already spent
  - `video_reserved` integer, required — Credits temporarily held by videos awaiting game info; these are not spent yet but are unavailable to another concurrent upload
  - `remaining` integer, required — Unspent and unreserved credits left (never negative)
  - `can_upload` boolean, required — False means the next POST /videos returns payment_required — send the user to the purchase page first
  - `return_url` string, nullable — HTTPS return URL bound to the requested user and video UUID, if one was supplied with POST /videos.

## Other responses

- `422` — Validation Error

## Changes

> 10 revisions in range; 6 could not be searched.

- **2026-08-12** `16e2b6a1c2bb` — 2 breaking, 1 info
  - the response property `org_id` became optional for the status `200`
  - response property `org_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the required property `user_id` to the response with the `200` status

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/accounts/:org_id/get.md)

---

[API](https://skmtc.dev/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.dev/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/revisions/9b0abde08b06/schema)