---
title: "Retrieve TTS API usage data"
method: GET
path: "/v1/voice-usage"
tags: ["usage"]
---

# Retrieve TTS API usage data

`GET /v1/voice-usage`

Retrieves a list of all TTS API usage records filtered by a specified date range. All dates are in UTC+0 timezone.

## Query parameters

- `start_date` string, required
- `end_date` string, required

## Response `200`

A list of TTS API usage records matching the specified date range.

- GetUsageListV1Response
  - `usages` GetUsageResponseV1Data[], required
    - `date` string, required — The date of the API usage in YYYY-MM-DD format.
    - `voice_id` string, required — The unique identifier for the voice used in the API call.
    - `name` string — The name of the voice used in the API call.
    - `style` string — The style of the voice used in the API call.
    - `language` string — The language of the voice used in the API call.
    - `total_minutes_used` number, required — The total duration (in minutes) of API usage for the specified voice and date.
    - `model` string — The model name used for text-to-speech.
    - `thumbnail_url` string — The URL to the thumbnail image for the voice.

## Other responses

- `401` — Unauthorized: Invalid API key
- `500` — Internal Server Error: Failed to get usages

---

[API](https://skmtc.net/supertoneapi/apis/supertone-public-api.md) · [All operations](https://skmtc.net/supertoneapi/apis/supertone-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supertoneapi/supertone-public-api/revisions/1ac6d0957e70/schema)