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

# List recent posts

`GET /posts`

## Request

- Base URL: `https://doomscrollr.com/api/v1`
- URL: `https://doomscrollr.com/api/v1/posts`
- Auth: HTTP bearer

## Query parameters

- `per_page` integer
- `page` integer
- `q` string
- `status` 'published' | 'draft' | 'scheduled'
- `tag` string

## Response `200`

Paginated list of posts

- PaginatedPosts
  - `current_page` integer
  - `data` Post[]
    - `id` integer
    - `url` string
    - `title` string
    - `description` string
    - `image` string, uri
    - `status` 'published' | 'draft' | 'scheduled'
    - `post_type` string
    - `created_at` string, date-time
    - `publish_at` string, date-time, nullable
  - `per_page` integer
  - `total` integer

## Other responses

- `429`: Monthly API rate limit exceeded

---

[API](https://skmtc.dev/doomscrollr/apis/doomscrollr-api.md) · [All operations](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/revisions/0bd7ab034196?raw)