> 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.

# List chat_groups

GET https://api.hume.ai/v0/evi/chat_groups

Fetches a paginated list of **Chat Groups**.

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

## Authentication

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

## Request

### 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.
- `config_id` (string, optional) — The unique identifier for an EVI configuration. Filter Chat Groups to only include Chats that used this `config_id` in their most recent Chat.

## Response

### 200

Success

- `chat_groups_page` (list of return_chat_group, required) — List of Chat Groups and their metadata returned for the specified `page_number` and `page_size`.
- `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.

## Types

### return_chat_group

A description of chat_group and its status

- `first_start_timestamp` (long, required) — Time at which the first Chat in this Chat Group was created. Measured in seconds since the Unix epoch.
- `id` (string, required) — Identifier for the Chat Group. Any Chat resumed from this Chat Group will have the same `chat_group_id`. Formatted as a UUID.
- `most_recent_start_timestamp` (long, required) — Time at which the most recent Chat in this Chat Group was created. Measured in seconds since the Unix epoch.
- `num_chats` (integer, required) — The total number of Chats associated with this Chat Group.
- `active` (boolean, optional)
- `most_recent_chat_id` (string, optional, nullable) — The `chat_id` of the most recent Chat in this Chat Group. Formatted as a UUID.
- `most_recent_config` (return_config_spec, optional) — The Config associated with this Chat.

### return_config_spec

The Config associated with this Chat.

- `id` (string, required) — Identifier for a Config. Formatted as a UUID.
- `version` (integer, optional, nullable) — Version number for a Config. Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number.

## Examples

**Response**

```json
{
  "chat_groups_page": [
    {
      "first_start_timestamp": 1721844196397,
      "id": "697056f0-6c7e-487d-9bd8-9c19df79f05f",
      "most_recent_start_timestamp": 1721861821717,
      "num_chats": 5,
      "active": false,
      "most_recent_chat_id": "dfdbdd4d-0ddf-418b-8fc4-80a266579d36"
    }
  ],
  "page_number": 0,
  "page_size": 1,
  "pagination_direction": "ASC",
  "total_pages": 1
}
```