---
title: "Get Usage Report"
method: GET
path: "/reports/vod"
tags: ["Reports"]
---

# Get Usage Report

`GET /reports/vod`

'This report returns a breakdown of video on demand minute usage by day and grouping. It will contain two top-level keys: total and statistics. total will contain the sum of all statistics returned in the report. statistics will contain an entry for each day and grouping. If you do not use the report grouping feature of the API the report will contain only one entry per day. These statistics are collected about once per hour, but there is only one record per day (per grouping). By default this report excludes the current day from the response because it is only partially complete. It is important to note that our service operates in the UTC time zone (including billing periods). All dates and times reported will be in UTC.'

## Query parameters

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

## Headers

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

## Response `200`

Get account details 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)