List posts

When set, returns posts scheduled in that calendar month, plus posts published immediately (no scheduled_at) in that month. Boundaries are widened by 14 hours each side so local-time edge days aren't dropped.

Filter by post status; omit or all for no status filter.

Max posts to return, clamped to 1-50 (a non-numeric value means 20). If omitted: 50, or the whole month (up to 999 posts) when month is set. hasMore and nextOffset in the response tell you whether another page exists.

Number of posts to skip for pagination, paired with limit. Non-numeric or negative values are treated as 0.

Optional sort order. published_at_desc returns the most recently published posts first (unpublished posts last); created_at_desc the most recently created first; updated_at_desc the most recently changed first (useful for catching failures on older posts). Omit for the default order (soonest scheduled first).

Optional. updated_at adds each post's updated_at to the response: the time the post last changed, which moves when it is published or fails. Pair it with order=updated_at_desc when polling for failures.