---
title: "GET /assets/account"
method: GET
path: "/assets/account"
tags: ["Account"]
---

# GET /assets/account

`GET /assets/account`

Show your account's credit balance, plan and auto top-up settings. `credits.available` is what generations can spend right now (plan_credits + extra - used); `resets_at` is when the plan's monthly credits refill (unix seconds). When `team_pool` is true the balance is your team's shared pool, and `auto_topup` is null because the team owner manages it. Check this before an expensive generation instead of waiting for a 402. Buying credits and changing auto top-up happen in the web app at `billing_url`. This is a free read-only lookup (no credits, no generation). Requires an API key (user scope).

## Response `200`

Success

- AccountInfo
  - `credits` object
    - `available` number, float — Credits generations can spend right now.
    - `plan_credits` number, float — The plan's credits for the current cycle.
    - `used` number, float — Plan credits used this cycle.
    - `extra` number, float — Credits from top-ups and grants, on top of the plan.
    - `resets_at` integer — When the plan credits refill (unix seconds).
    - `team_pool` boolean — The balance is a team's shared pool.
    - `paused` boolean
    - `grace_until` integer — Set when the subscription ended; remaining credits stay spendable until then (unix seconds).
  - `plan` object
    - `name` string
    - `api_access` boolean
  - `auto_topup` object — Null for team members; the team owner manages auto top-up.
    - `enabled` boolean
    - `threshold` number, float — An automatic top-up is bought when available credits drop below this.
    - `credits` integer — Credits bought on each automatic top-up.
  - `billing_url` string — Web page to buy credits, change plan or change auto top-up.

## Other responses

- `400` — Error

## Changes

- **2026-09-26** `9fb1b21a5bec` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/assets/account/get.md)

---

[API](https://skmtc.dev/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.dev/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ludo/apis/ludo-ai-api/revisions/a6d8dcc39b12?raw)