---
title: "Get welcome credit and training balance"
method: GET
path: "/api/agent/v1/account"
tags: ["Account"]
---

# Get welcome credit and training balance

`GET /api/agent/v1/account`

## Request

- Base URL: `https://nicevois.com`
- URL: `https://nicevois.com/api/agent/v1/account`
- Auth: HTTP bearer

Call before quoting or creating a job. Returns the connected account's welcome-credit status, balance, available packs, and a private browser handoff that keeps checkout on this same agent identity.

## Response `200`

Current connected NiceVois account state.

- TrainingAccount
  - `freeRuns` object, required
    - `total` integer, required
    - `used` integer, nullable, required
    - `remaining` integer, nullable, required
  - `freeRunMaxEpochs` integer
  - `freeRunMaxDurationSeconds` integer
  - `signedIn` boolean
  - `balance` object, nullable
    - `purchasedCents` integer, required
    - `spentCents` integer, required
    - `reservedCents` integer, required
    - `availableCents` integer, required
  - `checkoutEnabled` boolean, required
  - `products` BalanceProduct[]
    - `id` string, required
    - `name` string, required
    - `balanceCents` integer, required
    - `priceUsd` number, required
  - `accountUrl` string, uri, nullable, required: Short-lived private browser handoff for this same agent identity. Show it only to the authenticated user.

## Other responses

- `401`: Missing or invalid NiceVois agent credential.

---

[API](https://skmtc.dev/nicevois/apis/nicevois-agent-api.md) · [All operations](https://skmtc.dev/nicevois/apis/nicevois-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicevois/apis/nicevois-agent-api/revisions/6ef41022a089?raw)