---
title: "Returns the top 10 customers by usage count and their totals"
method: POST
path: "/reports/usage-tracking/top-customers/totals"
tags: ["Reporting"]
---

# Returns the top 10 customers by usage count and their totals

`POST /reports/usage-tracking/top-customers/totals`

## Request

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

## Request body

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

## Response `200`

topCustomersTotals 200 response

- UsageReportCustomersTotalsReport
  - `customers` UsageReportCustomerUsage[], required
    - `customer` string, nullable
    - `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)