---
title: "List posts: GET /posts | Posty dokumentáció"
description: "A naptár egy időszakra: minden poszt állapottal és időponttal."
canonical: https://posty.hu/en/docs/api/endpoints/bejegyzesek
source: https://posty.hu/en/docs/api/endpoints/bejegyzesek.md
---

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

| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| startDate | lekérdezés | ISO 8601 date | yes | The start of the period, in UTC. |
| endDate | lekérdezés | ISO 8601 date | yes | The end of the period, in UTC. |
| customer | lekérdezés | 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_a_kulcsod"
```

Kód másolása

## Response

Example response structure. The [OpenAPI document](https://posty.hu/openapi.json) 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" }
    }
  ]
}
```

Kód másolása

## Related

- [Authentication](https://posty.hu/en/docs/api/authentication): API key and scopes.
- [Errors and limits](https://posty.hu/en/docs/api/errors): error responses and rate limits.
- [All endpoints](https://posty.hu/en/docs/api/endpoints): full list.

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.