---
title: amp metrics
description: "Reference for amp metrics list and get, for reading saved metric definitions."
product: general
lang: en
last_updated: 2026-11-18
token_estimate: 521
---
# amp metrics

`amp metrics` lists and reads saved metric definitions. This read-only command family requires the `analytics:read` scope.

## `amp metrics list`

Returns saved metrics in the project. Results are paginated with cursor-based pagination. Full metric definitions are included in list responses.

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

Sortable fields are `updated_at` and `name`; prefix with `-` for descending. Defaults to `-updated_at` (most recently updated first).

```bash
amp metrics list --project <project_id> --limit 10
```

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--cursor` | string | No | Opaque cursor from `pagination.next_cursor` on the previous response. Numeric offsets are capped by the underlying search index (10,000 results per query). Well-formed pagination stops before that window; requests whose cursor would exceed it return 400 `pagination_not_supported`. Alias: `--next-cursor`. |
| `--limit` | integer | No | Number of items to return. Defaults to 50, max 200. |
| `--q` | string | No | Full-text search query. Alias: `--query`. |
| `--metric-type` | string | No | Filter list results to a specific metric type. |
| `--sort` | string | No | Sort field. Prefix with `-` for descending. Supported values are `updated_at` and `name`. |

Requires the `analytics:read` scope.

## `amp metrics get`

Returns the full saved metric definition including type-specific params, version, and metadata.

```bash
amp metrics get --project <project_id> --metric <metric_id>
```

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--metric` | string | Yes | Saved metric identifier. Alias: `--metric-id`. |

Requires the `analytics:read` scope.

