---
title: "Get organization account balance"
method: GET
path: "/organizations/{orgId}/balance/"
tags: ["Organizations"]
---

# Get organization account balance

`GET /organizations/{orgId}/balance/`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/organizations/{orgId}/balance/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/organizations/:orgId/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` integer, required

## Response `200`

OK

- GetOrganizationBalanceResponse
  - `success` boolean: Indicates whether the request was successful.
  - `data` BalanceDataObject
    - `userid` integer: User ID
    - `orgid` integer: Organization ID
    - `balance` string: Current balance in USD
    - `promobalance` string: Promotional balance in USD
    - `minbalance` string: Minimum balance threshold for auto top-off in USD
    - `topoffamount` string: Amount to add when balance falls below minbalance in USD
    - `has_postpay` 0 | 1: 1 if the org has postpay billing enabled
    - `pendingcharges` string, nullable: Pending charges not yet applied to balance in USD

## Other responses

- `400`: Invalid org ID
- `401`: Unauthorized
- `403`: Forbidden — billing_visible permission required

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)