List Posts

Returns a paginated list of posts in the workspace, optionally filtered by status.

GET /api/public/v1/posts

Query Parameters

Parameter	Type	Default	Description
`status`	string	all	Filter by post status, e.g. `scheduled`, `processing`, `published`, `failed`
`limit`	number	50	Results per page (max 100)
`offset`	number	0	Pagination offset

Example Request

curl "https://outstand.one/api/public/v1/posts?status=scheduled&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "posts": [
    {
      "id": "post_abc123",
      "content": "Excited to share our latest update!",
      "status": "scheduled",
      "publish_mode": "scheduled",
      "scheduled_at": "2026-08-15T09:00:00.000Z",
      "published_at": null,
      "outstand_post_id": null,
      "created_at": "2026-07-15T10:00:00.000Z"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}