---
title: "List taxonomy analytics run history"
method: GET
path: "/v1/taxonomies/{taxonomy_id}/analytics/runs"
tags: ["Taxonomy Analytics"]
---

# List taxonomy analytics run history

`GET /v1/taxonomies/{taxonomy_id}/analytics/runs`

List previously executed step-analytics runs (transitions and paths) for a taxonomy, newest-executed first. Runs are de-duplicated by their parameters, so re-running the same analysis updates the existing entry and bumps its run_count instead of creating a duplicate.

## Path parameters

- `taxonomy_id` string, required

## Query parameters

- `analysis_type` 'transitions' | 'paths' — Kind of taxonomy step-analytics computed for a persisted run. Attributes: TRANSITIONS: Direct A→B transition analytics (conversion rate, durations, predictor lifts) produced by the ``/analytics/transitions`` endpoint. PATHS: Multi-step path discovery produced by the ``/analytics/paths`` endpoint.
- `collection_id` string, nullable — Filter by collection ID
- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page

## Response `200`

Successful Response

- TaxonomyAnalyticsRunListResponse — Paginated list of persisted taxonomy analytics runs. Attributes: runs: The runs on this page (sorted newest-executed first). total: Total number of runs matching the filters. page: 1-indexed page number. page_size: Number of runs per page.
  - `runs` TaxonomyAnalyticsRun[], required — Runs on this page
    - `run_id` string, required — Stable run identifier (taxrun_...)
    - `taxonomy_id` string, required — Taxonomy analyzed
    - `collection_id` string, required — Collection analyzed
    - `analysis_type` 'transitions' | 'paths', required — Kind of taxonomy step-analytics computed for a persisted run. Attributes: TRANSITIONS: Direct A→B transition analytics (conversion rate, durations, predictor lifts) produced by the ``/analytics/transitions`` endpoint. PATHS: Multi-step path discovery produced by the ``/analytics/paths`` endpoint.
    - `params` object — Request params used for the run
    - `params_hash` string, required — De-dup hash of the normalized params
    - `from_step` string, required — Starting step
    - `to_step` string, required — Ending step
    - `name` string, nullable — Optional run label
    - `result` object, nullable — Computed analytics result
    - `status` string — Run status
    - `error_message` string, nullable — Error message if the run failed
    - `run_count` integer — Number of times these params have been executed
    - `namespace_id` string — Tenant namespace
    - `internal_id` string — Tenant/org id
    - `created_at` string, date-time, nullable — First persisted at
    - `updated_at` string, date-time, nullable — Last (re-)executed at
  - `total` integer, required — Total matching runs
  - `page` integer, required — 1-indexed page number
  - `page_size` integer, required — Runs per page

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

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