---
title: "List distinct metric volumes by metric name"
method: GET
path: "/api/v2/metrics/{metric_name}/volumes"
tags: ["Metrics"]
---

# List distinct metric volumes by metric name

`GET /api/v2/metrics/{metric_name}/volumes`

View hourly average cardinality for the given metric name over the look back period.
For Metric Name Pricing customers, view total point volume for the given metric name
over the look back period.

## Path parameters

- `metric_name` string, required

## Query parameters

- `window[seconds]` integer

## Response `200`

Success

- MetricVolumesResponse — Response object which includes a single metric's volume.
  - `data` union — Possible response objects for a metric's volume.
    - MetricDistinctVolume — Object for a single metric's distinct volume.
      - `attributes` MetricDistinctVolumeAttributes — Object containing the definition of a metric's distinct volume.
        - `distinct_volume` integer — Distinct volume for the given metric.
      - `id` string — The metric name for this resource.
      - `type` 'distinct_metric_volumes' — The metric distinct volume type.
    - MetricIngestedIndexedVolume — Object for a single metric's ingested and indexed volume.
      - `attributes` MetricIngestedIndexedVolumeAttributes — Object containing the definition of a metric's ingested and indexed volume.
        - `indexed_volume` integer — Estimated average hourly number of indexed time series for the given metric over the last hour. For organizations on Metric Name Pricing, this represents the estimated sum of indexed data points over the last hour.
        - `ingested_volume` integer — Estimated average hourly number of ingested time series for the given metric over the last hour. This value is `0` for metrics not configured with Metrics Without Limits. For organizations on Metric Name Pricing, this represents the estimated sum of ingested data points over the last hour.
      - `id` string — The metric name for this resource.
      - `type` 'metric_volumes' — The metric ingested and indexed volume type.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

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