> ## Documentation Index
> Fetch the complete documentation index at: https://plivo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Retrieve Plivo Text-to-Speech usage for your account, split by batch and realtime.

> [!NOTE]
>
> Get your account's Text-to-Speech usage: requests, characters and audio seconds, split by batch and realtime.

A `Usage` object totals your Text-to-Speech use per route: `http` for [batch](https://plivo.com/docs/models/text-to-speech/api/batch.md) and `live` for [realtime](https://plivo.com/docs/models/text-to-speech/api/realtime.md).

## The Usage Object

### Attributes

**auth\_id** `string`

Your account.

**routes** `object`

Usage per route: `http` and `live`.

**route**

**requests** `integer`

Number of batch requests or realtime replies.

**characters** `integer`

Billed characters.

**spoken\_chars** `integer`

Characters spoken after normalization.

**audio\_seconds** `number`

Seconds of audio generated.

**tokens** `integer`

### Example Usage Object

```json theme={null}
{
  "api_id": "148d6af0bee98c09",
  "auth_id": "<auth_id>",
  "routes": {
    "live": {"requests": 552, "characters": 39948, "tokens": 34511, "audio_seconds": 2760.88, "spoken_chars": 38282},
    "http": {"requests": 198, "characters": 12011, "tokens": 10400, "audio_seconds": 820.5, "spoken_chars": 11800}
  }
}
```

***

## Retrieve Usage

Get usage totals for your account.

```text theme={null}
GET https://api.plivo.com/v1/Account/{auth_id}/TTS/Usage/
```

### Arguments

No arguments required.&#x20;

```bash cURL theme={null}
curl "https://api.plivo.com/v1/Account/<auth_id>/TTS/Usage/" \
  -u '<auth_id>:<auth_token>'
```

### Response

Returns the [Usage object](#the-usage-object).
