---
title: "List the roundups"
method: GET
path: "/roundups/index.json"
tags: ["stories"]
---

# List the roundups

`GET /roundups/index.json`

## Request

- Base URL: `https://hangingcontext.com`
- URL: `https://hangingcontext.com/roundups/index.json`
- Auth: none required

List the recent roundups. A roundup groups related stories.

## Headers

- `HC-API-Version` '1'

## Response `200`

The recent roundups.

- RoundupList: The recent roundups. A roundup groups related stories.
  - `schema` string
  - `type` string
  - `generated_at` string, date-time
  - `roundups` object[], required
    - `title` string, required
    - `dek` string
    - `url` string, uri, required
    - `json` string, uri
    - `scope` object, required: What the roundup covers. The type is topic, beat or topics.
      - `type` string
      - `label` string
    - `edition` string
    - `published_at` string, date-time, required
    - `story_count` integer

## Other responses

- `404`: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.

---

[API](https://skmtc.dev/hangingcontext/apis/hanging-context-public-read-api.md) · [All operations](https://skmtc.dev/hangingcontext/apis/hanging-context-public-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hangingcontext/apis/hanging-context-public-read-api/revisions/48912c502036?raw)