> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List taxonomy analytics run history > 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. ## OpenAPI ````yaml get /v1/taxonomies/{taxonomy_id}/analytics/runs openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: - BearerAuth: [] paths: /v1/taxonomies/{taxonomy_id}/analytics/runs: get: tags: - Taxonomy Analytics summary: List taxonomy analytics run history description: >- 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. operationId: list_analytics_runs_v1_taxonomies__taxonomy_id__analytics_runs_get parameters: - name: taxonomy_id in: path required: true schema: type: string title: Taxonomy Id - name: analysis_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/AnalysisType' - type: 'null' description: Filter by analysis type (transitions or paths) title: Analysis Type description: Filter by analysis type (transitions or paths) - name: collection_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by collection ID title: Collection Id description: Filter by collection ID - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-indexed) default: 1 title: Page description: Page number (1-indexed) - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 20 title: Page Size description: Items per page responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TaxonomyAnalyticsRunListResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] NamespaceHeader: [] components: schemas: AnalysisType: type: string enum: - transitions - paths title: AnalysisType description: |- 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. TaxonomyAnalyticsRunListResponse: properties: runs: items: $ref: '#/components/schemas/TaxonomyAnalyticsRun' type: array title: Runs description: Runs on this page total: type: integer title: Total description: Total matching runs page: type: integer title: Page description: 1-indexed page number page_size: type: integer title: Page Size description: Runs per page type: object required: - runs - total - page - page_size title: TaxonomyAnalyticsRunListResponse description: |- 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. ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TaxonomyAnalyticsRun: properties: run_id: type: string title: Run Id description: Stable run identifier (taxrun_...) taxonomy_id: type: string title: Taxonomy Id description: Taxonomy analyzed collection_id: type: string title: Collection Id description: Collection analyzed analysis_type: $ref: '#/components/schemas/AnalysisType' description: transitions or paths params: additionalProperties: true type: object title: Params description: Request params used for the run params_hash: type: string title: Params Hash description: De-dup hash of the normalized params from_step: type: string title: From Step description: Starting step to_step: type: string title: To Step description: Ending step name: anyOf: - type: string - type: 'null' title: Name description: Optional run label result: anyOf: - additionalProperties: true type: object - type: 'null' title: Result description: Computed analytics result status: type: string title: Status description: Run status default: completed error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the run failed run_count: type: integer title: Run Count description: Number of times these params have been executed default: 1 namespace_id: type: string title: Namespace Id description: Tenant namespace default: '' internal_id: type: string title: Internal Id description: Tenant/org id default: '' created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: First persisted at updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At description: Last (re-)executed at type: object required: - run_id - taxonomy_id - collection_id - analysis_type - params_hash - from_step - to_step title: TaxonomyAnalyticsRun description: >- A persisted taxonomy step-analytics run. Every time a user runs a transitions or paths analysis, the request parameters and the computed result are stored (upserted, de-duplicated by a hash of the normalized params) so the run can be listed, reviewed, and re-run later. Re-running the same parameters updates the existing record and increments ``run_count`` rather than creating a duplicate. Attributes: run_id: Stable identifier for the run (``taxrun_``). taxonomy_id: Taxonomy the analytics were computed against. collection_id: Collection the analytics were computed against. analysis_type: ``transitions`` or ``paths``. params: The request parameters used (``exclude_none`` dump of the request body). Enough to reconstruct and re-run the analysis. params_hash: SHA-256 of the normalized params (plus analysis_type and collection_id) — the upsert de-duplication key. from_step: Convenience copy of the transition's starting step. to_step: Convenience copy of the transition's ending step. name: Optional user-provided label for the run. result: The computed analytics result (``model_dump`` of the response). status: Run status; ``completed`` on success. error_message: Populated only when a run failed. run_count: Number of times these exact params have been executed. namespace_id: Tenant namespace (auto-populated by the provider). internal_id: Tenant/org id (auto-populated by the provider). created_at: When the run was first persisted. updated_at: When the run was last (re-)executed. ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: >- 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. NamespaceHeader: type: apiKey in: header name: X-Namespace description: >- 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`. ````