---
title: "Returns the list of known customers"
method: GET
path: "/reports/usage-tracking/customers"
tags: ["Reporting"]
---

# Returns the list of known customers

`GET /reports/usage-tracking/customers`

## Request

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

## Query parameters

- `filter` UsageReportFilter, required
  - `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, required
  - `fromDate` string, date-time, nullable
  - `toDate` string, date-time, nullable
  - `timezone` string, nullable

## Response `200`

knownCustomers 200 response

- string[]

---

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