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

List charts

Returns saved charts in the project. Results are paginated with cursor-based
pagination. Chart definitions are omitted; use GET chart with
include_definition=true to retrieve a read-only definition.

Pagination uses an opaque numeric cursor (offset into the current sorted
search result set). Each list query can access at most 10,000 matching
charts from the search index; pages beyond that window return fewer items
and next_cursor: null even when more charts may exist in the project.
Use filters (q, chart_type) to narrow large projects.

Sortable fields are updated_at and name; prefix with - for descending.
Defaults to -updated_at (most recently updated first). created_at is not
supported in this API version.

get/v1/projects/{project_id}/charts

Authorizations

Authorizationstringrequired

http

Path parameters

project_idstringrequired

Amplitude project identifier, backed by the canonical app ID.

Example:12345
Constraints:pattern: ^[0-9]+$

Query parameters

cursorstring

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.

Constraints:nullable
limitinteger

Number of items to return. Defaults to 50, max 200.

Default:50
Constraints:min: 1max: 200
qstring

Full-text search query.

chart_typestring

Filter list results to a specific chart type. Use unknown to return charts whose type is not represented by a public API value.

Allowed values:event_segmentationsessionsfunnelsretentioncompositionrevenue_ltvstickinessdata_tableengagement_matrixmetric_explorergrowth_accountingimpactusersunknown
sortstring

Sort field. Prefix with - for descending. Supported values are updated_at and name.

Example:-updated_at

Response

application/json
200· Successful response.
dataobject[]required
Show child attributes
idstringrequired

Stable chart identifier.

objectstringrequired

Resource-type discriminator. Always chart.

project_idstringrequired
Constraints:pattern: ^[0-9]+$
namestringrequired
descriptionstring
Constraints:nullable
chart_typestringrequired

Public chart type discriminator (snake_case). All values may appear on list/get; query returns 422 (unsupported_chart_type) for types outside the v1 supported matrix.Unsupported or unrecognized chart types are surfaced as unknown.New chart types may be added over time. Clients should treat unknown as "a chart type this API version does not model yet".

Allowed values:event_segmentationsessionsfunnelsretentioncompositionrevenue_ltvstickinessdata_tableengagement_matrixmetric_explorergrowth_accountingimpactusersunknown
created_atstringrequired

ISO-8601 creation time, or null when unavailable.

Constraints:format: date-timenullable
updated_atstringrequired

ISO-8601 last-modified time, or null when unavailable.

Constraints:format: date-timenullable
created_bystring

Chart creator. The creator's email when available, otherwise a login identifier; null when the creator cannot be resolved.

Constraints:nullable
urlstringrequired

Deep link to the chart in the Amplitude UI.

Constraints:format: uri
archivedbooleanrequired

Whether the chart is archived.

definitionobject

Read-only chart definition. Returned only when include_definition=true on GET chart. Shape is unstable and may change between API versions; not intended for authoring.

paginationobjectrequired
Show child attributes
next_cursorstringrequired

Cursor for the next page, or null on the last page. Chart list responses may stop before all project charts are enumerated because the search backend caps each query at 10,000 sorted hits.

Constraints:nullable
has_morebooleanrequired

Was this helpful?