---
title: "List cached audio entries"
method: GET
path: "/v1/agents/{agentId}/audio-cache"
tags: ["Audio Cache"]
---

# List cached audio entries

`GET /v1/agents/{agentId}/audio-cache`

List cached TTS audio entries for an agent with metadata including transcript, provider, voice, duration, and hit count.

## Query parameters

- `limit` integer
- `offset` integer
- `sort` string

## Response `200`

Successful response

- ListAudioCacheResponse
  - `entries` AudioCacheEntry[], required
    - `id` string, required — Audio cache entry ID. Although serialized as a string, the ID is numeric — endpoints that accept an `entryId` path parameter return `400 Invalid ID` if the value cannot be parsed as an integer.
    - `transcript` string, required — Transcript used for cache lookup
    - `cachedAt` string, date-time, required — ISO 8601 timestamp of when entry was cached
    - `hitCount` integer, required — Number of cache hits
    - `duration` number, float, required — Audio duration in seconds
    - `regenerated` boolean, required — Whether this entry has been regenerated
    - `provider` string, required — TTS provider tied to this audio cache entry (e.g. 'eleven_labs', 'google', 'play_ht', 'cartesia', 'hume', 'minimax', 'rime', 'poly_tts', 'resemble', 'nemo', 'microsoft')
    - `providerVoiceId` string, required — The ID of the voice cataloged in the TTS provider's system. If your TTS provider is PolyAI, this is an internally assigned voice ID. If you are using a third-party provider, this is the voice ID from that provider's catalog (e.g. '21m00Tcm4TlvDq8ikWAM' for ElevenLabs, 'en-US-Neural2-A' for Google).
    - `audioFilename` string, nullable — Original audio filename, if any.
    - `imported` boolean, required — Whether this entry was imported
    - `languageCode` string — BCP-47 language code. May be an empty string for legacy entries created before language was tracked.
  - `totalCount` integer, required — Total matching entries before pagination

## Other responses

- `400` — Invalid request – the `sort` or `filter` expression could not be parsed
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – the API key does not have `read` permission on the audio cache resource

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)