---
title: "Comments"
method: GET
path: "/api/comments"
tags: ["comments"]
---

# Comments

`GET /api/comments`

This endpoint allows the client to retrieve all comments belonging to an article or podcast episode as threaded conversations.

It will return the all top level comments with their nested comments as threads. See the format specification for further details.

It supports pagination, each page will contain `50` top level comments (and as many child comments they have) by default.

If the page parameter is not passed, all comments of an article or podcast will be returned.

## Query parameters

- `page` integer
- `per_page` integer
- `a_id` string
- `p_id` string
- `page` string

## Response `200`

A List of Comments

- Comment[]
  - `type_of` string
  - `id_code` string
  - `created_at` string, date-time
  - `image_url` string, url — Podcast image url

## Other responses

- `404` — Resource Not Found

## Changes

- **2026-07-13** (v1) `7db6ba099285` — 1 breaking, 1 warning, 1 info
  - removed the media type `application/json` for the response with the status `404`
  - deleted the `query` request parameter `page`
  - added the new optional `query` request parameter `page`
- **2026-07-13** (v1) `6550ad7be94f` — 1 warning, 1 info
  - deleted the `query` request parameter `page`
  - added the new optional `query` request parameter `page`
- **2026-05-28** (v1) `6550ad7be94f` — 1 warning, 2 info
  - deleted the `query` request parameter `page`
  - added the new optional `query` request parameter `page`
  - added the media type `application/json` for the response with the status `404`
- **2026-05-07** (v1) `5407fa6a8633` — 1 warning, 1 info
  - deleted the `query` request parameter `page`
  - added the new optional `query` request parameter `page`
- **2026-03-20** (v1) `e7c44dde62b1` — 1 warning, 1 info
  - deleted the `query` request parameter `page`
  - added the new optional `query` request parameter `page`

[Full history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/comments/get.md)

---

[API](https://skmtc.dev/forem/apis/forem-api-v1.md) · [All operations](https://skmtc.dev/forem/apis/forem-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/forem/forem-api-v1/revisions/7db6ba099285/schema)