---
title: "List patterns clustered points"
method: GET
path: "/api/v2/llm-obs/v1/topic-discovery-clustered-points"
tags: ["LLM Observability"]
---

# List patterns clustered points

`GET /api/v2/llm-obs/v1/topic-discovery-clustered-points`

List the data points grouped into a topic. For a parent topic, points from all
of its leaf topics are returned.

## Query parameters

- `topic_id` string, required
- `page_size` integer
- `page_token` string

## Response `200`

OK

- LLMObsPatternsClusteredPointsResponse — Response containing the clustered points of an LLM Observability topic.
  - `data` LLMObsPatternsClusteredPointsResponseData, required — Data object of an LLM Observability patterns clustered points response.
    - `attributes` LLMObsPatternsClusteredPointsResponseAttributes, required — Attributes of an LLM Observability patterns clustered points response.
      - `next_page_token` string, nullable, required — Pagination token for the next page of points. Null if there are no more pages.
      - `points` LLMObsPatternsClusteredPoint[], required — List of clustered points.
        - `event_id` string, required — Identifier of the source event.
        - `id` string, required — Unique identifier of the clustered point.
        - `input` string, required — Input text of the source span.
        - `is_included` boolean, required — Whether the point is included in the patterns dataset.
        - `is_suggested` boolean, required — Whether the point is suggested for inclusion in the patterns dataset.
        - `session_id` string, required — Identifier of the source session.
        - `span_id` string, required — Identifier of the source span.
        - `topic_id` string, required — Identifier of the topic the point belongs to.
      - `topic_id` string, required — Identifier of the topic the points belong to.
    - `id` string, required — Identifier of the topic the points belong to.
    - `type` 'clustered_points_response', required — Resource type of an LLM Observability patterns clustered points response.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)