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

# List patterns runs

`GET /api/v2/llm-obs/v1/topic-discovery-runs`

List the completed patterns runs for a configuration.

## Query parameters

- `config_id` string, required

## Response `200`

OK

- LLMObsPatternsRunsResponse — Response containing the completed runs of an LLM Observability patterns configuration.
  - `data` LLMObsPatternsRunsResponseData, required — Data object of an LLM Observability patterns runs response.
    - `attributes` LLMObsPatternsRunsResponseAttributes, required — Attributes of an LLM Observability patterns runs response.
      - `runs` LLMObsPatternsRunSummary[], required — List of patterns runs.
        - `completed_at` string, date-time, nullable — Timestamp when the run completed. Null if the run has not completed.
        - `config_snapshot` LLMObsPatternsConfigSnapshot — Snapshot of the configuration used for a patterns run.
          - `account_id` string — Integration account ID used for a bring-your-own-model run.
          - `evp_query` string — Query that selected the spans for the run.
          - `hierarchy_depth` integer — Depth of the topic hierarchy generated.
          - `integration_provider` string — Integration provider used for a bring-your-own-model run.
          - `model_name` string — Model name used for a bring-your-own-model run.
          - `num_records` integer — Maximum number of records processed for the run.
          - `sampling_ratio` number, double — Fraction of matching spans sampled for the run.
        - `created_at` string, date-time, required — Timestamp when the run was created.
        - `id` string, required — Unique identifier of the run.
        - `status` string, required — Status of the run.
    - `id` string, required — Identifier of the configuration the runs belong to.
    - `type` 'list_topic_discovery_runs_response', required — Resource type of a list of LLM Observability patterns runs.

## 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)