---
title: "List all posts"
method: GET
path: "/posts"
tags: ["Posts"]
---

# List all posts

`GET /posts`

Retrieve all recent posts to browse what others are sharing

## Response `200`

Successfully retrieved posts

- Post[]
  - `id` string, uuid, required — Unique identifier for the post
  - `username` string, required — Username of the post author
  - `content` string, required — Content of the post
  - `createdAt` string, date-time, required — Timestamp when the post was created
  - `updatedAt` string, date-time, required — Timestamp when the post was last updated
  - `likesCount` integer, required — Number of likes on the post
  - `commentsCount` integer, required — Number of comments on the post

## Other responses

- `500` — Internal server error

## Changes

- **2026-07-17** `41c89b420e85` — 2 breaking, 1 info
  - the `items/content` response property's maxLength was increased from `1000` to `2000` for the response status `200`
  - the `details` response's property type changed from `object` to `array` for status `500`
  - api operation id `listPosts` removed and replaced with `getPosts`
- **2025-05-30** `2775bd09f55e` — 3 breaking, 5 info
  - the `items/id` response's property type changed from `integer` to `string`, and format from no format to `uuid` for status `200`
  - removed the required property `items/commentCount` from the response with the `200` status
  - removed the required property `items/likeCount` from the response with the `200` status
  - api operation id `getPosts` removed and replaced with `listPosts`
  - …4 more
- **2025-05-30** `dbaf42ae4311` — 8 breaking, 1 warning, 2 info
  - the `items/content` response property's maxLength was unset from `2000` 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`
  - the `items/username` response property's minLength was decreased from `1` to `0` for the response status `200`
  - …7 more

[Change history](https://skmtc.dev/azure/apis/simple-social-media-api/changes/posts/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)