---
title: "List virtual currency balances"
method: GET
path: "/api/v2/server-side-api/vc/balances/"
tags: ["Virtual Currency"]
---

# List virtual currency balances

`GET /api/v2/server-side-api/vc/balances/`

Returns the current balance of every virtual currency for a profile. If the app has no virtual currencies, `data` is an empty array.

## Headers

- `adapty-customer-user-id` string
- `adapty-profile-id` string

## Response `200`

Balances returned successfully

- VirtualCurrencyBalanceListResponse — Current balances for all virtual currencies of a profile.
  - `response_created_at` integer, required — When the response was generated, as a Unix timestamp in milliseconds.
  - `data` VirtualCurrencyProfileBalanceItem[], required
    - `code` string, required — Unique virtual currency code within the app. ASCII letters, digits, and underscore.
    - `name` string, required — Display name of the virtual currency.
    - `balance` integer, required — Total balance, including amounts currently held.
    - `held` integer, required — Sum of all active holds (reserved amounts). Currently always 0.
    - `available` integer, required — Balance available to spend, computed as `balance - held`.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. The API key is missing or invalid.
- `403` — Forbidden. The Server API for virtual currencies is not enabled for this app.
- `404` — Profile not found.
- `500` — Internal server error

---

[API](https://skmtc.dev/adapty/apis/adapty-server-side-api.md) · [All operations](https://skmtc.dev/adapty/apis/adapty-server-side-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adapty/adapty-server-side-api/revisions/abdc1c773a17/schema)