---
title: "Get Minutes Used"
method: GET
path: "/reports/minutes"
tags: ["Reports"]
---

# Get Minutes Used

`GET /reports/minutes`

'In API version 2 /vod and /minutes return the same data, so this endpoint is identical to `https://app.zencoder.com/api/v2/reports/vod`.'

## Query parameters

- `from` string
- `to` string
- `grouping` string

## Headers

- `Content-Type` string, required
- `Zencoder-Api-Key` string, required

## Response `200`

Get minutes used response.

- GetUsageReportResponse — Account usage report response
  - `total` object — Summary object
    - `encoded_minutes` integer — The total encoding minutes used
    - `billable_minutes` integer — The encoding minutes that were billable
  - `statistics` object — Reports by grouping
    - `grouping` string — The grouping for these jobs. `null` is for all ungrouped jobs
    - `collected_on` string — Date of the report in `YYYY-MM=DD` format
    - `encoded_minutes` integer — The total encoding minutes used for this group
    - `billable_minutes` integer — The encoding minutes that were billable for this group

## Other responses

- `403` — Forbidden
- `500` — Server error

---

[API](https://skmtc.net/brightcovelearning/apis/zencoder-api.md) · [All operations](https://skmtc.net/brightcovelearning/apis/zencoder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightcovelearning/zencoder-api/versions/1c9ad03e166e/schema)