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

# Computes the data required for the Usage Tracking report broken down by story

`POST /reports/usage-tracking/by-story`

## Request

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

## Request body

- UsageReportByStoryRequest
  - `backlogItemIds` string, required
  - `customer` UsageReportCustomerQuery
    - `operator` string, required
    - `customers` string[], required
  - `location` UsageReportLocationQuery
    - `operator` string, required
    - `locations` UsageReportLocationSpecifier[], required
      - `level` string, required
      - `location` string[], required
  - `environmentIds` string, nullable
  - `interval` UsageReportInterval
    - `fromDate` string, date-time, nullable
    - `toDate` string, date-time, nullable
    - `timezone` string, nullable
  - `resolution` 'DAY' | 'WEEK' | 'MONTH'

## Response `200`

usageEventsReportWithFilteringByStory 200 response

- UsageReportStoryUsageBin[]
  - `backlogItemId` string, uuid, required
  - `time` string, date-time, required
  - `usageCount` integer, nullable

---

[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)