---
title: amp charts
description: "Reference for amp charts list, get, and query, for reading and querying saved Amplitude charts."
product: general
token_estimate: 490
---
# amp charts

> 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`.

`amp charts` lists, inspects, and queries saved charts. This read-only command family requires the `analytics:read` scope.

## `amp charts list`

```bash
amp charts list --project <project_id> --limit 5
amp charts list --project <project_id> --chart-type funnels --sort -updated_at
```

Use `--q` to search by name and `--chart-type` to narrow the results. Sort by `updated_at` or `name`; prefix the value with `-` for descending order. The default is `-updated_at`.

List responses omit chart definitions. In an interactive terminal, `amp` prints a table. Pipe the result or pass `--json` to get the raw API response.

## `amp charts get`

```bash
amp charts get --project <project_id> --chart <chart_id>
amp charts get --project <project_id> --chart <chart_id> --include-definition
```

Pass `--include-definition` to include the chart's read-only definition. Its shape may change between API versions, so don't use it to author or update charts.

## `amp charts query`

```bash
amp charts query --project <project_id> --chart <chart_id>
amp charts query --project <project_id> --chart <chart_id> \
  --time-range '{"start":"2026-07-01","end":"2026-07-31"}' \
  --timezone America/Los_Angeles
```

Query supports event segmentation, sessions, funnels, and retention charts. Other chart types return `422` with `error_code: "unsupported_chart_type"`.

If you omit `--time-range`, the query uses the chart's saved range or the last 30 days when the chart has no saved range. The command also accepts `--exclude-incomplete-datapoints`, `--group-by-limit`, and `--time-series-limit`. Run `amp charts query --help` for the complete parameter reference.

Although query uses an HTTP POST, it only computes results and doesn't modify the chart. It doesn't require an idempotency key.