---
title: Berichten weergeven
openapi: /openapi/firmreader.yaml GET /posts
lastUpdated: "2026-08-21"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

`GET https://api.firmreader.com/v1/posts`

Retrieve a paginated list of posts. Filter by channel, author, tag, or date range.

## Authentication

- `bearerAuth` — http bearer (API Key)

## Query parameters

- `channel_id` (string) — Filter by channel ID.
- `author_id` (string) — Filter by author user ID.
- `tag` (string) — Filter by tag.
- `priority` (string) — Filter by priority level.
- `published_after` (string) — Only return posts published after this timestamp.
- `published_before` (string) — Only return posts published before this timestamp.
- `limit` (integer) — Number of posts to return per page.
- `cursor` (string) — Cursor for pagination. Use the `next_cursor` from the previous response.

## Response 200

List of posts
  - response (object)
    - `data` (array)
      - `items` (object)
        - `id` (string) — Unique post identifier.
        - `channel_id` (string) — Channel the post belongs to.
        - `title` (string) — Post headline.
        - `body` (string) — Post content in Markdown.
        - `priority` (string, one of: normal, high, urgent) — Notification priority level.
        - `tags` (array) — Tags for categorization.
          - `items` (string)
        - `author` (object)
          - `id` (string)
          - `name` (string)
          - `email` (string)
        - `status` (string, one of: draft, scheduled, published, archived) — Current status of the post.
        - `published_at` (string, date-time) — When the post was published.
        - `scheduled_at` (string, date-time) — Scheduled publish time, if applicable.
        - `cover_image_url` (string, uri)
        - `views` (integer) — Number of unique readers.
        - `created_at` (string, date-time)
        - `updated_at` (string, date-time)
    - `next_cursor` (string) — Cursor for the next page. Null if no more results.
    - `has_more` (boolean) — Whether there are more results.

## Response 401

Unauthorized
  - response (object)
    - `error` (object)
      - `code` (string) — Machine-readable error code.
      - `message` (string) — Human-readable error message.
      - `param` (string) — The parameter that caused the error, if applicable.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.firmreader.com/api-specs.zip