---
title: "Read (List) Topic Comments"
method: GET
path: "/api/v2/users/:userId/topics/:topicId/comments"
tags: ["comments"]
---

# Read (List) Topic Comments

`GET /api/v2/users/:userId/topics/:topicId/comments`

returns all comments of the topic user has access to

## Path parameters

- `userId` string, required
- `topicId` string, required

## Query parameters

- `orderBy` 'rating' | 'popularity' | 'date'

## Response `200`

Returns comments list

- object
  - `status` object
    - `code` integer
  - `data` object
    - `count` integer — comments count
    - `rows` CommentInList[]
      - `type` string
      - `subject` string
      - `text` integer
      - `parent` object
        - `id` string, uuid
        - `version` integer
      - `creator` object
        - `id` string
        - `name` string
        - `company` string
      - `edits` object[]
        - `createdAt` string
        - `subject` string
        - `text` string
        - `type` 'pro' | 'con' | 'reply'
      - `createdAt` string
      - `updatedAt` string
      - `deletedAt` string
      - `deletedBy` object
        - `id` string
      - `deletedReasonText` string
      - `deletedReasonType` 'abuse' | 'obscene' | 'spam' | 'hate' | 'netiquette' | 'duplicate'
      - `replies` CommentInList[]
      - `report` object
        - `id` string, uuid
      - `votes` object
        - `count` integer
        - `up` object
          - `count` integer
        - `down` object
          - `count` integer

## Changes

> 10 revisions in range; 1 could not be searched.

- **2018-08-20** `3ff54b27e8aa` — 1 info
  - endpoint added
- **2018-08-20** `ba36cd387928` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/citizenos/apis/citizenos-api/changes/api/v2/users/:userId/topics/:topicId/comments/get.md)

---

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