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

# List posts

`GET /posts`

## Request

- Base URL: `https://www.socialfaktory.com/v1`
- URL: `https://www.socialfaktory.com/v1/posts`
- Auth: HTTP bearer

List posts with their scheduled time, the link they were released at, and their metrics. A post just sent stays queued until the publisher takes it, then turns scheduled. A release link and metrics appear once the channel reports back, which takes a few minutes.

## Query parameters

- `brand_id` string
- `status` 'draft' | 'scheduled' | 'published' | 'failed' | 'queued'
- `page` integer

## Response `200`

List posts

- object
  - `posts` object[], required
    - `id` string, required
    - `status` string, required
    - `caption` string, nullable
    - `scheduled_at` string, nullable
    - `failure_code` string, nullable
    - `channel_id` string, required
    - `provider` string, required
  - `page` integer, required
  - `pages` integer, required

## Other responses

- `default`: The error envelope

---

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