---
title: "Query billing transactions"
method: GET
path: "/v1/organizations/{organization_id}/billing_transactions"
tags: ["Organization"]
---

# Query billing transactions

`GET /v1/organizations/{organization_id}/billing_transactions`

## Request

- Base URL: `https://api.telerivet.com`
- URL: `https://api.telerivet.com/v1/organizations/{organization_id}/billing_transactions`
- Auth: one of:
  - HTTP basic
  - OAuth 2 (authorization code, authorization URL `https://telerivet.com/oauth/authorize`, token URL `https://api.telerivet.com/oauth/token`)

Queries the billing transaction history for this organization — each posted charge, payment, credit, refund, and adjustment on the organization's account balance.

 Transactions are returned most recent first by default (unlike most query methods, `sort_dir` defaults to `desc`).

 Amounts are in the organization's billing currency, with charges negative and payments/credits positive. Each transaction also includes the organization's account balance immediately after the transaction was posted.

 Usage-based charges (such as per-message fees and overage charges) accumulate throughout the day and are posted to the transaction history approximately once per day, so the most recent usage may not yet appear as posted transactions. Pass `include_pending=true` to also retrieve the current pending (not yet posted) usage charges in a separate `pending_transactions` property of the response (available via the REST API; the pending items have no `new_balance` since they are not yet posted).

## Path parameters

- `organization_id` string, required

## Query parameters

- `time_posted` integer: Unix timestamp in seconds
- `entry_type` string
- `usage_category` string
- `usage_country` string
- `usage_network` string
- `project_id` string: ID of Project
- `phone_id` string: ID of Phone
- `include_pending` boolean
- `sort_dir` 'asc' | 'desc'
- `page_size` integer
- `offset` integer
- `marker` string
- `count` boolean

## Response `200`

Successful response. When count=1 parameter is provided, returns {"count": N} instead.

- object
  - `data` object[]: Array of results (omitted when count=1)
  - `truncated` boolean: True if there are more results
  - `next_marker` string: Marker for pagination
  - `page_size` integer: Number of results per page
  - `sort_dir` 'asc' | 'desc': Sort direction
  - `count` integer: Total count of matching items (only when count=1 parameter is provided)

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key or Bearer token
- `404`: Resource not found

---

[API](https://skmtc.dev/telerivet/apis/telerivet-api.md) · [All operations](https://skmtc.dev/telerivet/apis/telerivet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telerivet/apis/telerivet-api/revisions/4e14b1c8d917?raw)