---
title: "Get timeline metrics for flow executions"
method: GET
path: "/v2/flows/{id}/executions/timeline"
tags: ["Flows Api Service"]
---

# Get timeline metrics for flow executions

`GET /v2/flows/{id}/executions/timeline`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/flows/{id}/executions/timeline`
- Auth: none declared

## Path parameters

- `id` integer, required

## Query parameters

- `metric` string, required
- `scope` string
- `timezone` string

## Response `200`

Timeline retrieved successfully

- JsonOkListResponseTimelineSeries
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` TimelineSeries[]
    - `metric` string
    - `values` SeriesValue[]
      - `dateTime` string, date-time
      - `value` number, double
    - `aggregate` TimelineAggregate
      - `aggregation` string
      - `value` number, double

## Other responses

- `401`: User not authenticated
- `403`: Insufficient permissions
- `404`: Flow not found

---

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