---
title: "Get firm Tally voice usage telemetry"
method: GET
path: "/tally/voice/usage"
tags: ["Tally Voice"]
---

# Get firm Tally voice usage telemetry

`GET /tally/voice/usage`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/tally/voice/usage`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns non-blocking Eastern-calendar-month voice usage telemetry for the authenticated firm. Caps are not enforced.

## Response `200`

Tally voice usage

- TallyVoiceUsage
  - `enabled` boolean, required
  - `unlimited` boolean: When true, remainingSeconds is null and caps are not enforced.
  - `periodKey` string, required: Eastern Time calendar month.
  - `includedSeconds` integer, required
  - `purchasedSeconds` integer, required
  - `allowanceSeconds` integer, required
  - `usedMilliseconds` integer, required
  - `reservedMilliseconds` integer, required
  - `remainingSeconds` integer, nullable
  - `percentUsed` number, required
  - `warningLevel` 'none' | 'warning' | 'near_cap' | 'capped', required
  - `maxSessionSeconds` integer, required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)