---
title: "List posts with cursor-based pagination and optional series filtering"
method: GET
path: "/api/posts"
tags: ["Posts"]
---

# List posts with cursor-based pagination and optional series filtering

`GET /api/posts`

# Errors
Returns error if posts database query fails, series filtering fails, or connection issues occur

## Query parameters

- `offset` string, uuid, nullable
- `limit` integer, nullable
- `series_id` string, uuid, nullable

## Response `200`

Posts list retrieved

- PostResponse[] — List of posts with pagination support
  - `audioFileId` string, uuid, nullable — ID of associated audio file
  - `content` string, required — Post body text and content
  - `createdAt` string, date-time, nullable — Post creation timestamp
  - `id` string, uuid, required — Post's unique identifier
  - `isPublished` boolean, required — Whether the post is published and visible to users
  - `postNumber` integer, required — Position number for ordering this post within its parent series
  - `seriesId` string, uuid, required — Parent series identifier
  - `slug` string, required — SEO-friendly URL identifier for the post
  - `thumbnailUrl` string, nullable — URL to the post's thumbnail image
  - `title` string, required — Post display title
  - `updatedAt` string, date-time, nullable — Post last update timestamp
  - `videoFileId` string, uuid, nullable — ID of associated video file

## Other responses

- `401` — Authentication required to list posts
- `403` — Access denied - cannot list posts for series not owned by user
- `500` — Server error during post listing

## Changes

- **2025-10-02** `6348840d4fcf` — 1 breaking
  - removed the required property `items/isPremium` from the response with the `200` status
- **2025-09-24** `143443c14b73` — 2 info
  - the endpoint scheme security `bearerAuth AND cookieAuth` was added to the API
  - the endpoint scheme security `cookieAuth` was removed from the API
- **2025-09-22** `08a2378b4e66` — 1 info
  - endpoint added
- **2025-09-01** `a2488be8a6e4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/patroninc/apis/patron-api/changes/api/posts/get.md)

---

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