---
title: "Top Pipelines Usage"
method: GET
path: "/v4/metrics/top-pipelines-usage"
tags: ["Metrics"]
---

# Top Pipelines Usage

`GET /v4/metrics/top-pipelines-usage`

## Request

- Base URL: `https://www.mystic.ai`
- URL: `https://www.mystic.ai/v4/metrics/top-pipelines-usage`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `access-token`
- TypeScript: <https://skmtc.dev/mystic/apis/mystic-api/docs/v4/metrics/top-pipelines-usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve usage metrics for top 'num_pipelines' (in terms of number of
runs) for the provided time period.

## Query parameters

- `num_pipelines` integer
- `start` string, date-time, required
- `end` string, date-time, required
- `interval_unit` 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks', required: An enumeration.
- `interval_value` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mystic/apis/mystic-api.md) - [All operations](https://skmtc.dev/mystic/apis/mystic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mystic/apis/mystic-api/revisions/60e569344994?raw)