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

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

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

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/reports/usage-tracking/top-customers`
- 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`

topCustomers 200 response

- UsageReportCustomerUsageReport
  - `bins` UsageReportCustomerReportRecordBin[], required
    - `time` string, date-time, required
    - `customers` UsageReportCustomerUsage[], required
      - `customer` string, nullable
      - `usageCount` integer, nullable
  - `knownCustomers` 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)