---
title: "GET /app/period_metric_usage/"
method: GET
path: "/app/period_metric_usage/"
tags: ["app"]
---

# GET /app/period_metric_usage/

`GET /app/period_metric_usage/`

Return current usage for a customer during a given billing period.

## Query parameters

- `end_date` string, date, required
- `start_date` string, date, required
- `top_n_customers` integer

## Response `200`

- PeriodMetricUsageResponse
  - `metrics` object, required

## Changes

- **2023-01-18** `b818a956b825` — 1 breaking
  - removed the required property `metrics/additionalProperties/total_usage` from the response with the `200` status
- **2023-01-16** `36b48cae00a3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/uselotus/apis/lotus-api/changes/app/period_metric_usage/get.md)

---

[API](https://skmtc.dev/uselotus/apis/lotus-api.md) · [All operations](https://skmtc.dev/uselotus/apis/lotus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uselotus/apis/lotus-api/revisions/0507a54ad455?raw)