Posts

List posts: GET /posts

A naptár egy időszakra: minden poszt állapottal és időponttal.

Path

Method and path
GEThttps://api.posty.hu/public/v1/posts
Authorization
posts:read
operationId
listPosts

The reading side of the calendar: the posts in the requested period, with status, channel, and publish time.

Parameters

NameLocationTypeRequiredDescription
startDatelekérdezésISO 8601 dateyesThe start of the period, in UTC.
endDatelekérdezésISO 8601 dateyesThe end of the period, in UTC.
customerlekérdezésstringnoFilter to one client group.

Request

curl "https://api.posty.hu/public/v1/posts?startDate=2026-09-01T00:00:00.000Z&endDate=2026-09-30T23:59:59.000Z" \
  -H "Authorization: psty_a_kulcsod"

Response

Example response structure. The OpenAPI document contains the authoritative schema for each field.

{
  "posts": [
    {
      "id": "clp0s7t8u9v0w1x2",
      "group": "grp_9f8e7d6c",
      "state": "QUEUE",
      "publishDate": "2026-09-15T09:00:00.000Z",
      "integration": { "id": "clx1a2b3c4d5e6f7g8h9", "providerIdentifier": "x" }
    }
  ]
}

Related

Is something missing from this page? Email [email protected] or use the form on the Help page.