---
title: "Credit balance and storage usage"
method: GET
path: "/account"
tags: ["Account"]
---

# Credit balance and storage usage

`GET /account`

## Request

- Base URL: `https://vocaless.app/api/v1`
- URL: `https://vocaless.app/api/v1/account`
- Auth: HTTP bearer

Everything needed to predict a `402` before you spend a request on one: the prepaid balance separation is charged against, how much storage is used against the limit, and the live per-minute rate. Separation costs 4 credits (cents) per minute of audio, or a flat 20 when you start a job without sending `duration_seconds`.

## Response `200`

Success

- object
  - `balance_cents` number, required
  - `separation_cents_per_minute` number, required
  - `separation_fallback_cents` number, required
  - `storage` object, required
    - `accrued_microcents` number, required
    - `delinquent` boolean, required
    - `external_provider` string, nullable, required
    - `limit_bytes` number, required
    - `migrating` boolean, required
    - `mode` 'external' | 'platform', required
    - `overage_enabled` boolean, required
    - `song_count` number, required
    - `used_bytes` number, required

## Other responses

- `401`: `UNAUTHORIZED` — Missing, malformed, or revoked API key.
- `429`: `RATE_LIMITED` — Too many requests for this API key.

---

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