> This page is for Voice APIs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://dev.hume.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://dev.hume.ai/_mcp/server.

# Get chat group audio

GET https://api.hume.ai/v0/evi/chat_groups/{id}/audio

Fetches a paginated list of audio for each **Chat** within the specified **Chat Group**. For more details, see our guide on audio reconstruction [here](/docs/speech-to-speech-evi/faq#can-i-access-the-audio-of-previous-conversations-with-evi).

Reference: https://dev.hume.ai/voice/reference/speech-to-speech-evi/chat-groups/get-audio

## Authentication

- `X-Hume-Api-Key` header (required) — API Key authentication via header

## Request

### Path parameters

- `id` (string, required) — Identifier for a Chat Group. Formatted as a UUID.

### Query parameters

- `page_number` (integer, optional, default: 0) — Specifies the page number to retrieve, enabling pagination. This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.
- `page_size` (integer, optional) — Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10.
- `ascending_order` (boolean, optional) — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.

## Response

### 200

Success

- `audio_reconstructions_page` (list of ReturnChatAudioReconstruction, required) — List of chat audio reconstructions returned for the specified page number and page size.
- `id` (string, required) — Identifier for the chat group. Formatted as a UUID.
- `num_chats` (integer, required) — Total number of chats in this chatgroup
- `page_number` (integer, required) — The page number of the returned list. This value corresponds to the `page_number` parameter specified in the request. Pagination uses zero-based indexing.
- `page_size` (integer, required) — The maximum number of items returned per page. This value corresponds to the `page_size` parameter specified in the request.
- `pagination_direction` (enum, required)
  - Allowed values: `ASC`, `DESC`
- `total_pages` (integer, required) — The total number of pages in the collection.
- `user_id` (string, required) — Identifier for the user that owns this chat. Formatted as a UUID.

## Types

### ReturnChatAudioReconstruction

List of chat audio reconstructions returned for the specified page number and page size.

- `id` (string, required) — Identifier for the chat. Formatted as a UUID.
- `status` (enum, required)
  - Allowed values: `QUEUED`, `IN_PROGRESS`, `COMPLETE`, `ERROR`, `CANCELLED`
- `user_id` (string, required) — Identifier for the user that owns this chat. Formatted as a UUID.
- `filename` (string, optional, nullable) — Name of the chat audio reconstruction file.
- `modified_at` (long, optional, nullable) — The timestamp of the most recent status change for this audio reconstruction, formatted milliseconds since the Unix epoch.
- `signed_audio_url` (string, optional, nullable) — Signed URL used to download the chat audio reconstruction file.
- `signed_url_expiration_timestamp_millis` (long, optional, nullable) — The timestamp when the signed URL will expire, formatted as a Unix epoch milliseconds.

## Examples

**Response**

```json
{
  "audio_reconstructions_page": [
    {
      "id": "470a49f6-1dec-4afe-8b61-035d3b2d63b0",
      "status": "COMPLETE",
      "user_id": "e6235940-cfda-3988-9147-ff531627cf42",
      "filename": "e6235940-cfda-3988-9147-ff531627cf42/470a49f6-1dec-4afe-8b61-035d3b2d63b0/reconstructed_audio.mp4",
      "modified_at": 1729875432555,
      "signed_audio_url": "https://storage.googleapis.com/...etc.",
      "signed_url_expiration_timestamp_millis": 1730232816964
    }
  ],
  "id": "369846cf-6ad5-404d-905e-a8acb5cdfc78",
  "num_chats": 1,
  "page_number": 0,
  "page_size": 10,
  "pagination_direction": "ASC",
  "total_pages": 1,
  "user_id": "e6235940-cfda-3988-9147-ff531627cf42"
}
```