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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/llm-obs/v1/topic-discovery-clustered-points`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)