---
title: "List balance history for an organization"
method: GET
path: "/organizations/{orgId}/balancehistory/"
tags: ["Organizations"]
---

# List balance history for an organization

`GET /organizations/{orgId}/balancehistory/`

## Request

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

## Path parameters

- `orgId` integer, required

## Query parameters

- `limit` integer
- `before` integer
- `after` integer
- `timestart` integer
- `timeend` integer
- `startafter` integer
- `tagid` integer
- `tagids` string
- `tagname` string
- `transactionTypeId` string

## Response `200`

OK

- ListOrganizationBalanceHistoryResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer: ID of the last record returned, for cursor-based pagination
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results
  - `data` BalanceHistoryEntry[]
    - `id` integer: Transaction ID
    - `orgid` integer: Organization ID
    - `amount` string: Transaction amount in USD (negative for charges)
    - `description` string: Transaction description
    - `time` string: Transaction timestamp (UTC)
    - `transaction_type_id` string: Transaction type identifier
    - `orderid` integer: Associated order ID, if any
    - `linkids` string[]: Profile cellular link IDs associated with this transaction

## Other responses

- `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/69a5b58e05fb?raw)