---
title: "Get Workflow Metrics"
method: GET
path: "/v1/workflows/{workflow_name}/metrics"
tags: ["workflows.metrics"]
---

# Get Workflow Metrics

`GET /v1/workflows/{workflow_name}/metrics`

Get comprehensive metrics for a specific workflow.

Args:
    workflow_name: The name of the workflow type to get metrics for
    start_time: Optional start time filter (ISO 8601 format)
    end_time: Optional end time filter (ISO 8601 format)

Returns:
    WorkflowMetrics: Dictionary containing metrics:
        - execution_count: Total number of executions
        - success_count: Number of successful executions
        - error_count: Number of failed/terminated executions
        - average_latency_ms: Average execution duration in milliseconds
        - retry_rate: Deprecated, always -1. Never measured retries; use error_count instead
        - latency_over_time: Time-series data of execution durations

Example:
    GET /v1/workflows/MyWorkflow/metrics
    GET /v1/workflows/MyWorkflow/metrics?start_time=2025-01-01T00:00:00Z
    GET /v1/workflows/MyWorkflow/metrics?start_time=2025-01-01T00:00:00Z&end_time=2025-12-31T23:59:59Z

## Path parameters

- `workflow_name` string, required

## Query parameters

- `start_time` string, date-time, nullable — Filter workflows started after this time (ISO 8601)
- `end_time` string, date-time, nullable — Filter workflows started before this time (ISO 8601)

## Response `200`

Successful Response

- WorkflowMetrics — Complete metrics for a specific workflow. This type combines all metric categories.
  - `execution_count` ScalarMetric, required — Scalar metric with a single value.
    - `value` union, required
      - integer
      - number
  - `success_count` ScalarMetric, required — Scalar metric with a single value.
    - `value` union, required
      - integer
      - number
  - `error_count` ScalarMetric, required — Scalar metric with a single value.
    - `value` union, required
      - integer
      - number
  - `average_latency_ms` ScalarMetric, required — Scalar metric with a single value.
    - `value` union, required
      - integer
      - number
  - `latency_over_time` TimeSeriesMetric, required — Time-series metric with timestamp-value pairs.
    - `value` array[], required
      - unknown[]
        - unknown
  - `retry_rate` ScalarMetric, required — Scalar metric with a single value.
    - `value` union, required
      - integer
      - number

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `fa73befe1c61` — 1 info
  - response property `retry_rate` deprecated

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/workflows/:workflow_name/metrics/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/fa73befe1c61?raw)
