---
title: "Get organization billing history"
method: GET
path: "/api/v1/balance/history"
tags: ["Account"]
---

# Get organization billing history

`GET /api/v1/balance/history`

## Request

- Base URL: `https://api.reteno.com`
- URL: `https://api.reteno.com/api/v1/balance/history`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/reteno/apis/reteno-com/docs/api/v1/balance/history/get.ts> (a function with typed inputs; its response is checked against the schema)

The method returns the billing history of the account.

## Query parameters

- `dateFrom` string
- `dateTo` string

## Response `200`

- BillingHistory
  - `currency` 'BYR' | 'CAD' | 'GBP' | 'EUR' | 'KZT' | 'RUB' | 'UAH' | 'USD': Currency code
  - `dailyCosts` BillingHistoryDay[]: Array of data by days
    - `date` string, date-time: Detail date
    - `channelDetails` ChannelCosts[]: An array of data for each media channel
      - `mediaType` 'email' | 'sms' | 'viber' | 'mobilepush' | 'webpush' | 'appinbox' | 'widget' | 'inapp' | 'telegrambot': Media channel
      - `totalSent` integer: The number of sent messages for a given day
      - `totalParts` integer: The number of <i>parts</i> in sent messages<br>Relevant for <b>SMS messages</b>: they can contain one or more parts<br>For other media channels will be equal to totalSent.
      - `bonusSpent` integer: Debited prepaid messages
      - `fundsWithdrawal` number, double: Debited funds
      - `fundsRefund` number, double: Returned funds<br>May be relevant for <b>SMS</b> and/or <b>Viber</b> media channels
      - `bonusReceived` integer: Received prepaid messages. Accrued when subscription is connected/renewed
      - `reservedFundsWithdrawal` number, double: Debited reserved funds.<br>May be relevant for <b>Viber</b> media channel only
      - `reservedFundsRefund` number, double: Returned reserved funds.<br>May be relevant for <b>Viber</b> media channel only

## Other responses

- `400`: dateTo must be greater or equal to dateFrom
- `419`: Request period must be not greater than 90 days

---

[API](https://skmtc.dev/reteno/apis/reteno-com.md) - [All operations](https://skmtc.dev/reteno/apis/reteno-com/llms.txt) - [OpenAPI document](https://skmtc.dev/reteno/apis/reteno-com/revisions/7e3e7243824f?raw)