---
title: "Fetch a cluster"
method: GET
path: "/ai/clusters/{task_id}"
tags: ["Clusters"]
---

# Fetch a cluster

`GET /ai/clusters/{task_id}`

## Path parameters

- `task_id` string, required

## Query parameters

- `top_n_nodes` integer
- `show_subclusters` boolean

## Response `200`

Successful Response

- ClusteringStatusResponseData
  - `data` ClusteringStatusResponse, required
    - `status` 'pending' | 'starting' | 'running' | 'completed' | 'failed', required
    - `bucket` string, required
    - `clusters` RecursiveCluster[], required
      - `cluster_id` string, required
      - `cluster_header` string
      - `cluster_summary` string, required
      - `nodes` ClusterNode[]
        - `filename` string, required — The corresponding source file of your embedded storage bucket that the node is from.
        - `text` string, required — The text of the node.
      - `total_number_of_nodes` integer, required
      - `subclusters` RecursiveCluster[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)