---
title: "Computes the data required for the Usage Tracking report"
method: POST
path: "/reports/usage-tracking"
tags: ["Reporting"]
---

# Computes the data required for the Usage Tracking report

`POST /reports/usage-tracking`

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/reports/usage-tracking`
- Auth: API key in header `X-API-KEY`

## Request body

- UsageReportRequest
  - `filter` UsageReportFilter
    - `backlogItemId` string, uuid, required
    - `customer` UsageReportCustomerQuery
      - `operator` string, required
      - `customers` string[], required
    - `location` UsageReportLocationQuery
      - `operator` string, required
      - `locations` UsageReportLocationSpecifier[], required
        - `level` string, required
        - `location` string[], required
  - `interval` UsageReportInterval
    - `fromDate` string, date-time, nullable
    - `toDate` string, date-time, nullable
    - `timezone` string, nullable
  - `resolution` 'DAY' | 'WEEK' | 'MONTH'

## Response `200`

usageEventsReportWithFiltering 200 response

- UsageReport
  - `bins` UsageReportReportRecordBin[], required
    - `time` string, date-time, required
    - `environments` UsageReportEnvironmentUsage[], required
      - `environmentId` string, uuid, required
      - `environmentName` string, required
      - `usageCount` integer, nullable
  - `knownEnvironmentNames` string[], required

---

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