---
title: "Read an advertising account's balance breakdown"
method: GET
path: "/v1/admin/ads/accounts/{account_id}/balance"
tags: ["Operations"]
---

# Read an advertising account's balance breakdown

`GET /v1/admin/ads/accounts/{account_id}/balance`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/ads/accounts/{account_id}/balance`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-LOPPEE-API-Key`

Read an advertising account's balance breakdown. The response is scoped and validated by the runtime repository; unknown or unauthorized resources use the canonical error envelope.

## Path parameters

- `account_id` string, required

## Response `200`

Read an advertising account's balance breakdown response

- object: Purchased, promotional (with expiry) and available funds, invalid-tap credits, charges, the refundable purchased amount and a ledger/cache consistency flag. Promotional funds are spent first. Requires manage_billing.

## Other responses

- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)