Skip to main content
GET
List posts
Read access: a read-enabled personal or team REST API key, or a signed-in user. OAuth clients use the corresponding MCP tool through /mcp. List scheduled posts or post history with per-account delivery states. Scheduled includes groups with a scheduled, preparing or publishing delivery. History includes the remaining groups, including failed, uncertain and cancelled outcomes. It is not a list of confirmed publications alone. MCP clients can use list_posts for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Posted REST API key

Query Parameters

view
enum<string>

scheduled, history

Available options:
scheduled,
history
page
integer

integer

Required range: 1 <= x <= 9007199254740991
pageSize
integer

integer

Required range: 1 <= x <= 100

Response

Successful response. Examples are illustrative; field values vary by record.

items
object[]
total
integer
page
integer
pageSize
integer