---
title: "Get a list of metrics"
method: GET
path: "/api/v2/metrics"
tags: ["Metrics"]
---

# Get a list of metrics

`GET /api/v2/metrics`

Get a list of actively reporting metrics for your organization. Pagination is optional using the `page[cursor]` and `page[size]` query parameters.

Query parameters use bracket notation (for example, `filter[tags]`, `filter[queried][window][seconds]`). Pass them as standard URL query strings, URL-encoding the brackets if your client does not handle them. For example: `GET /api/v2/metrics?filter[tags]=env:prod&window[seconds]=86400&page[size]=500`.

## Query parameters

- `filter[configured]` boolean
- `filter[is_configurable]` boolean
- `filter[tags_configured]` string — Tag keys to filter by.
- `filter[metric_type]` 'non_distribution' | 'distribution' — The metric's type category.
- `filter[include_percentiles]` boolean
- `filter[queried]` boolean
- `filter[queried][window][seconds]` integer
- `filter[tags]` string
- `filter[related_assets]` boolean
- `include` string
- `sort` string
- `window[seconds]` integer
- `page[size]` integer
- `page[cursor]` string

## Response `200`

Success

- MetricsAndMetricTagConfigurationsResponse — Response object that includes metrics and metric tag configurations.
  - `data` MetricsAndMetricTagConfigurations[] — Array of metrics and metric tag configurations.
    - union — Object for a metrics and metric tag configurations.
      - Metric — Object for a single metric.
        - `id` string — The metric name for this resource.
        - `relationships` MetricRelationships — Relationships for a metric.
          - `metric_volumes` MetricVolumesRelationship — Relationship to a metric volume included in the response.
            - `data` MetricVolumesRelationshipData — Relationship data for a metric volume.
              - …
        - `type` 'metrics' — The metric resource type.
      - MetricTagConfiguration — Object for a single metric tag configuration.
        - `attributes` MetricTagConfigurationAttributes — Object containing the definition of a metric tag configuration attributes.
          - `aggregations` MetricCustomAggregation[] — Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.
            - `space` 'avg' | 'max' | 'min' | 'sum', required — A space aggregation for use in query.
            - `time` 'avg' | 'count' | 'max' | 'min' | 'sum', required — A time aggregation for use in query.
          - `created_at` string, date-time — Timestamp when the tag configuration was created.
          - `exclude_tags_mode` boolean — When set to true, the configuration will exclude the configured tags and include any other submitted tags. When set to false, the configuration will include the configured tags and exclude any other submitted tags. Defaults to false. Requires `tags` property.
          - `include_percentiles` boolean — Toggle to include or exclude percentile aggregations for distribution metrics. Only present when the `metric_type` is `distribution`.
          - `metric_type` 'gauge' | 'count' | 'rate' | 'distribution' — The metric's type.
          - `modified_at` string, date-time — Timestamp when the tag configuration was last modified.
          - `tags` string[] — List of tag keys on which to group.
        - `id` string — The metric name for this resource.
        - `relationships` MetricRelationships — Relationships for a metric.
          - `metric_volumes` MetricVolumesRelationship — Relationship to a metric volume included in the response.
            - `data` MetricVolumesRelationshipData — Relationship data for a metric volume.
              - …
        - `type` 'manage_tags' — The metric tag configuration resource type.
  - `included` MetricIngestedIndexedVolume[] — Array of metric volume resources included when requested with `include=metric_volumes`.
    - `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.
  - `links` MetricsListResponseLinks — Pagination links. Only present if pagination query parameters were provided.
    - `first` string — Link to the first page.
    - `last` string, nullable — Link to the last page.
    - `next` string, nullable — Link to the next page.
    - `prev` string, nullable — Link to previous page.
    - `self` string — Link to current page.
  - `meta` MetricPaginationMeta — Response metadata object.
    - `pagination` MetricMetaPage — Paging attributes. Only present if pagination query parameters were provided.
      - `cursor` string, nullable — The cursor used to get the current results, if any.
      - `limit` integer — Number of results returned
      - `next_cursor` string, nullable — The cursor used to get the next results, if any.
      - `type` 'cursor_limit' — Type of metric pagination.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `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)