amp charts

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

amp charts list

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

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

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.