---
title: "[BETA] Get aggregated metered requests for a given time period."
method: GET
path: "/api/admin/metrics/request"
tags: ["Metrics"]
---

# [BETA] Get aggregated metered requests for a given time period.

`GET /api/admin/metrics/request`

**Enterprise feature**

**[BETA]** This API is in beta state, which means it may change or be removed in the future.

Gets metered requests count for the selected period, either aggregated by day or by month.

## Query parameters

- `grouping` 'daily' | 'monthly', required
- `from` string, date, required
- `to` string, date, required

## Response `200`

meteredRequestsSchema

- MeteredRequestsSchema — Contains the recorded metered groups requests segmented by day/month
  - `grouping` 'monthly' | 'daily', required — Whether the data is aggregated by month or by day.
  - `dateRange` object, required — The date range there is data for. The range is inclusive and goes from the start of the `from` date to the end of the `to` date
    - `from` string, date, required — The start of the dateRange
    - `to` string, date, required — The end of the dateRange
  - `apiData` object[], required — Contains the recorded daily/monthly requests for each metered group
    - `meteredGroup` string, required — The metered group representing charging unit in the organization using Unleash
    - `dataPoints` object[], required — The recorded data points for the metered group
      - `period` string, required — The date of the data point. Formatted as a full date (e.g. 2023-04-01) if the data is aggregated by day or as a month (e.g. 2023-04) if the data is aggregated by month.
      - `requests` number, required — Number of requests

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)