Skip to main content
GET
List taxonomy analytics run history

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

taxonomy_id
string
required

Query Parameters

analysis_type
enum<string> | null

Filter by analysis type (transitions or 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.

Available options:
transitions,
paths
collection_id
string | null

Filter by collection ID

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
page_size
integer
default:20

Items per page

Required range: 1 <= x <= 100

Response

Successful Response

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 · object[]
required

Runs on this page

total
integer
required

Total matching runs

page
integer
required

1-indexed page number

page_size
integer
required

Runs per page