Posts
List posts: GET /posts
The calendar for a period: every post with its state and time.
Path
Method and path
GEThttps://api.posty.hu/public/v1/posts
Authorization
posts:readoperationId
listPostsThe reading side of the calendar: the posts in the requested period, with status, channel, and publish time.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| startDate | query | ISO 8601 date | yes | The start of the period, in UTC. |
| endDate | query | ISO 8601 date | yes | The end of the period, in UTC. |
| customer | query | string | no | Filter 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_your_key"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
- Authentication: API key and scopes.
- Errors and limits: error responses and rate limits.
- All endpoints: full list.
Is something missing from this page? Email [email protected] or use the form on the Help page.