Skip to main content
GET
List posts
Both startDate and endDate are required. Every post whose publish date falls between them comes back, whatever its state: QUEUE, PUBLISHED, ERROR or DRAFT.
  • Only the first post of each thread is listed, not its comments or later thread entries.
  • Posts of a channel you deleted are left out.
  • A repeating post appears once for each time it goes out in the range, each copy with actualDate set to the original date.
  • settings and image are JSON strings. Parse them before you read them.
  • A failed post carries the network’s reason in error.
Pass customer with a group id from List groups to see one customer’s channels only.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Query Parameters

startDate
string<date-time>
required

Start of the range, UTC, ISO 8601

endDate
string<date-time>
required

End of the range, UTC, ISO 8601

customer
string

Only posts of channels assigned to this customer id

Response

List of posts

posts
object[]
Last modified on September 23, 2026