---
title: "List every visible edition of an image's chart series"
method: GET
path: "/v1/images/{id}/chart-series"
tags: ["Images"]
---

# List every visible edition of an image's chart series

`GET /v1/images/{id}/chart-series`

## Request

- Base URL: `https://api.memestack.ai`
- URL: `https://api.memestack.ai/v1/images/{id}/chart-series`
- Auth: none declared

Editions of one chart republished over time (e.g. the same indicator's yearly release) share a series_key (spec 2026-09-25 chart sources §4). Works from ANY member of the series, not just the earliest — the id in the path only anchors which series to look up. 404 when the image is not visible (never 403), has no stored chart-metadata row, or that row has no series_key (not part of a series).

## Path parameters

- `id` string, uuid, required

## Query parameters

- `content` 'safe' | 'all'

## Response `200`

Every visible edition, newest first (proven period end, else release date, else snapshot date).

- object
  - `series_key` string
  - `editions` object[]
    - `id` string, uuid
    - `rendered_period` object, nullable
      - `start` integer
      - `end` integer
    - `published_at` string, nullable
    - `controversial` boolean

## Other responses

- `400`: INVALID_CONTENT — content must be 'safe' or 'all'.
- `404`: Image not found, not visible, has no chart-metadata row, or is not part of a series.

---

[API](https://skmtc.dev/memestack/apis/memestack-api.md) · [All operations](https://skmtc.dev/memestack/apis/memestack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/memestack/apis/memestack-api/revisions/9d3a19565f75?raw)