---
title: "List comments for a post"
method: GET
path: "/posts/{postId}/comments"
tags: ["Comments"]
---

# List comments for a post

`GET /posts/{postId}/comments`

Retrieve all comments on a specific post

## Path parameters

- `postId` string, uuid, required

## Response `200`

Successfully retrieved comments

- Comment[]
  - `id` string, uuid, required — Unique identifier for the comment
  - `postId` string, uuid, required — ID of the post this comment belongs to
  - `username` string, required — Username of the comment author
  - `content` string, required — Content of the comment
  - `createdAt` string, date-time, required — Timestamp when the comment was created
  - `updatedAt` string, date-time, required — Timestamp when the comment was last updated

## Other responses

- `404` — Resource not found
- `500` — Internal server error

## Changes

- **2026-07-17** `41c89b420e85` — 4 breaking, 1 info
  - added the new path request parameter `postId`
  - the `items/content` response property's maxLength was increased from `500` to `1000` for the response status `200`
  - the `details` response's property type changed from `object` to `array` for status `404`
  - the `details` response's property type changed from `object` to `array` for status `500`
  - …1 more
- **2025-05-30** `2775bd09f55e` — 2 breaking, 1 warning, 5 info
  - the `items/id` response's property type changed from `integer` to `string`, and format from no format to `uuid` for status `200`
  - the `items/postId` response's property type changed from `integer` to `string`, and format from no format to `uuid` for status `200`
  - deleted the `path` request parameter `postId`
  - api operation id `getComments` removed and replaced with `listComments`
  - …4 more
- **2025-05-30** `dbaf42ae4311` — 9 breaking, 2 warning, 1 info
  - for the `path` request parameter `postId`, the type changed from `string` to `integer`, and format from `uuid` to no format
  - the `items/content` response property's maxLength was unset from `1000` for the response status `200`
  - the `items/username` response property's maxLength was unset from `50` for the response status `200`
  - the `items/content` response property's minLength was decreased from `1` to `0` for the response status `200`
  - …8 more

[Change history](https://skmtc.dev/azure/apis/simple-social-media-api/changes/posts/:postId/comments/get.md)

---

[API](https://skmtc.dev/azure/apis/simple-social-media-api.md) · [All operations](https://skmtc.dev/azure/apis/simple-social-media-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/simple-social-media-api/revisions/41c89b420e85/schema)