---
title: "List Tasks"
method: GET
path: "/v1/tts/max"
tags: ["Voice AI Beta — Max"]
---

# List Tasks

`GET /v1/tts/max`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v1/tts/max`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v1/tts/max/get.ts> (a function with typed inputs; its response is checked against the schema)

Your Max task history (paginated, newest first). Items also carry `subtitle_available` (see *Export Subtitle*).
> **Rate limit:** 60 requests/minute

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated tasks

- TtsTaskListResponse: Paginated task list (per-provider lists and the merged `/v1/tts/history`)
  - `items` TtsTask[]
    - `id` string: Task ID
    - `title` string: Task title
    - `status` 'pending' | 'cloning' | 'queued' | 'processing' | 'merging' | 'process_merging' | 'completed' | 'failed': Voice AI Beta task lifecycle: `pending` → `cloning` (clone flow only) → `queued` → `processing` → `merging` → `process_merging` → `completed` | `failed`.
    - `provider` string: Provider: `nova`, `lyra`, `sirius`, `vega`, `max` (other values may appear as new providers launch)
    - `result` string: Audio file URL (empty until `completed`). Public; deleted about 90 days after creation (then `404`) — download it yourself.
    - `total_length` integer: Billable characters (encoder units ≈ UTF-8 bytes — see the Voice AI Beta tag)
    - `process_percentage` integer: Progress percentage
    - `error` string: Failure reason (only when `status` is `failed`)
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `total` integer: Total number of tasks
  - `page` integer
  - `limit` integer

## Other responses

- `429`: Rate limit exceeded

## Changes

- **2026-10-29** `8e065c159192`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/max/get.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) - [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/264ca07ba262?raw)