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

# List publish results

`GET /api/posts/results`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/posts/results`
- Auth: API key in header `x-api-key`

Flattened per-channel publish outcomes across your team's posts, so you
can see which posts succeeded or failed on which channel without fetching
each one individually. Team-scoped.

## Query parameters

- `status` 'DRAFT' | 'SCHEDULED' | 'PUBLISHING' | 'PUBLISHED' | 'FAILED' | 'APPROVAL'
- `provider` 'twitter' | 'instagram' | 'linkedin' | 'threads' | 'youtube' | 'tiktok' | 'bluesky'
- `page` integer
- `limit` integer

## Response `200`

Paginated publish results

- object
  - `success` boolean
  - `data` object
    - `results` PublishResultRow[]
      - `postGroupId` string
      - `provider` string
      - `channelName` string, nullable
      - `status` 'DRAFT' | 'SCHEDULED' | 'PUBLISHING' | 'PUBLISHED' | 'FAILED' | 'APPROVAL'
      - `publishedAt` string, date-time, nullable
      - `url` string, nullable: Public URL of the published post.
      - `platformPostId` string, nullable
      - `error` string, nullable: Failure message when status is FAILED.
      - `attempts` integer
    - `pagination` object
      - `total` integer
      - `page` integer
      - `limit` integer
      - `totalPages` integer

## Other responses

- `400`: No current team selected
- `401`: Missing or invalid API key

---

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