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

# List Posts

`GET /posts`

Retrieve a list of published posts from the blog.
You can specify page number and size, and include tag or author information.

The post body (content_html) is not included in list responses. Request it explicitly with fields[posts] when you need it.

## Query parameters

- `page` integer
- `limit` integer
- `fields[posts]` string
- `include` string
- `filter[slug]` string
- `filter[published]` boolean
- `filter[published_at_gte]` string, date-time
- `filter[published_at_lte]` string, date-time
- `filter[tag_id]` integer
- `filter[author_id]` string, uuid
- `filter[content_type]` 'tiptap' | 'notion'
- `sort` 'published_at' | 'created_at' | 'updated_at' | 'title'
- `order` 'asc' | 'desc'

## Response `200`

Post list retrieved successfully

## Other responses

- `401` — Authentication failed
- `403` — Insufficient permissions
- `500` — 서버 내부 오류

---

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