---
title: "Get drawdown balance"
method: GET
path: "/api/v1/billing/balance"
tags: ["Billing"]
---

# Get drawdown balance

`GET /api/v1/billing/balance`

Get current drawdown balance for the authenticated developer

## Response `200`

Balance in smallest currency unit and currency code

- BalanceResponse
  - `drawdownEnabled` boolean, required
  - `balance` Money, required
    - `currencyCode` string, required
    - `amountSubunits` integer, required

## Other responses

- `401` — Authentication Failed
- `422` — Validation Error

## Changes

- **2026-06-08** `0b28c67737d3` — 1 info
  - the security scope `billing:read` was added to the endpoint's security scheme `bearerAuth`

[Change history](https://skmtc.dev/rye-com/apis/universal-checkout-api/changes/api/v1/billing/balance/get.md)

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/b06e2a90de32/schema)