---
title: "Retrieve workflow task usage"
method: GET
path: "/workflows/metrics.json"
tags: ["Workflows"]
---

# Retrieve workflow task usage

`GET /workflows/metrics.json`

Gets workflow task usage sorted by day within a specified time frame.

### User Access Permission
You must be assigned the **Workflow View Access** permission to run this operation.

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `metrics` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string

## Response `200`

OK

- UsagesResponse
  - `metrics` WorkflowUsage[] — The list of tasks retrieved.
    - `date` string — The date when the usage record is created.
    - `values` object
      - `taskCount` integer — The amount of task runs that have been used.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)