---
title: "Prepaid balance and top-up rules"
method: GET
path: "/api/v1/balance"
---

# Prepaid balance and top-up rules

`GET /api/v1/balance`

## Request

- Base URL: `https://www.premierletters.com`
- URL: `https://www.premierletters.com/api/v1/balance`
- Auth: HTTP bearer

## Response `200`

Balance summary (balance_cents 0 and test: true for a test key)

- Balance
  - `balance_cents` integer: Prepaid balance; 0 for a test-mode key
  - `min_cents` integer: Minimum top-up (1000)
  - `max_cents` integer: Maximum top-up (6000000)
  - `tiers` object[]
    - `min_cents` integer
    - `bonus_pct` number
  - `presets_cents` integer[]
  - `next_tier` object, nullable
    - `min_cents` integer
    - `bonus_pct` number
  - `handling_fee_waived_when_paying_from_balance` boolean
  - `test` boolean

---

[API](https://skmtc.dev/premierletters/apis/premier-letters-api.md) · [All operations](https://skmtc.dev/premierletters/apis/premier-letters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/premierletters/apis/premier-letters-api/revisions/9dc302324ca1?raw)