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

# List posts

`GET /posts`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/posts`
- Auth: API key in header `Authorization`

Paginated list of the caller's scheduled/published posts, newest-scheduled first.

## Query parameters

- `status` 'pending' | 'queued' | 'publishing' | 'published' | 'failed' | 'rejected' | 'cancelled' | 'archived'
- `page` integer

## Response `200`

Paginated posts.

- PaginatedPostsResponse
  - `posts` Post[], required
    - `id` string, uuid
    - `platform` string
    - `content_text` string
    - `status` 'pending' | 'queued' | 'publishing' | 'published' | 'failed' | 'rejected' | 'cancelled'
    - `scheduled_at` string, date-time
    - `published_at` string, date-time, nullable
    - `source` 'manual' | 'ai_generated'
    - `platform_post_url` string, uri, nullable
    - `platform_post_id` string, nullable
    - `media_urls` string[]
    - `created_at` string, date-time
    - `error_message` string, nullable
    - `connected_accounts` object, nullable
      - `display_name` string, nullable
      - `avatar_url` string, nullable
    - `post_metrics` object[]
      - `likes` integer, nullable
      - `comments` integer, nullable
      - `reposts` integer, nullable
      - `impressions` integer, nullable
  - `total` integer, required
  - `page` integer, required
  - `pageSize` 20, required
  - `totalPages` integer, required

## Other responses

- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: Plan limit: no active plan (any write; `reason: "no_active_plan"`), a monthly allowance is spent, or the feature is not on the caller's plan. Detect by `code: "plan_limit_exceeded"`.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).

---

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