---
title: "Get the spendable credit balance"
method: GET
path: "/api/v1/balance"
tags: ["Account"]
---

# Get the spendable credit balance

`GET /api/v1/balance`

## Request

- Base URL: `https://www.seedance2ai.io`
- URL: `https://www.seedance2ai.io/api/v1/balance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/docs/api/v1/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

credits is the total the key owner can spend through the API. subscription_credits is the part of that total that came from a plan and expires at subscription_credits_expire_at. Team credits are not used by the API.

## Response `200`

The balance.

- object
  - `credits` number, required
  - `subscription_credits` number, required
  - `subscription_credits_expire_at` string, date-time, nullable, required

## Other responses

- `401`: unauthorized: the API key is missing, invalid, or revoked.
- `429`: rate_limited: submissions are limited to 30 per 60 seconds and reads to 120 per 60 seconds per account; Seedance requests that inspect reference media have a lower limit. Wait for Retry-After before retrying.
- `500`: internal_error: an unexpected server failure. Retry with the same Idempotency-Key; contact support if it persists.

---

[API](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api.md) - [All operations](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/revisions/e4ef5c6db219?raw)