---
title: "List posts, newest first."
method: GET
path: "/v1/posts"
tags: ["Posts"]
---

# List posts, newest first.

`GET /v1/posts`

## Request

- Base URL: `https://api.ravenpo.st`
- URL: `https://api.ravenpo.st/v1/posts`
- Auth: HTTP bearer

Without `page` this returns a plain array, matching the dashboard’s contract; with `page` it returns a paginated envelope. Automations should always pass `page` — a workspace with thousands of posts otherwise returns all of them in one response.

## Query parameters

- `status` string
- `platform` string
- `type` string
- `q` string
- `sort` string
- `page` number
- `limit` number

## Response `200`

Success

## Other responses

- `401`: Missing, malformed or revoked token
- `429`: Rate limited (120 requests/minute)

---

[API](https://skmtc.dev/ravenpo/apis/ravenpost-api.md) · [All operations](https://skmtc.dev/ravenpo/apis/ravenpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ravenpo/apis/ravenpost-api/revisions/82905d43e21d?raw)