---
title: "List posts"
method: GET
path: "/v4/posts"
tags: ["Posts"]
---

# List posts

`GET /v4/posts`

Returns a cursor-paginated list of the account's posts — content published to the creator's Kit site and/or sent by email — with each post's `status` (e.g. `draft`, `scheduled`, `published`), `slug`, `public_url`, `is_paid` flag, and timestamps for publishing and sending.

Post bodies are omitted by default; set `include_content=true` to embed the `content` HTML on each post (this significantly increases response size and latency for large collections — prefer [Get a post](/api-reference/posts/get-a-post) for a single body). A post that was also sent as a broadcast shares its `publication_id` with the matching broadcast from [List broadcasts](/api-reference/broadcasts/list-broadcasts).

## Query parameters

- `after` unknown
- `before` unknown
- `include_content` boolean
- `include_total_count` boolean
- `per_page` unknown

## Response `200`

Returns a paginated list of all posts for your account

- object
  - `posts` object[], required
    - `id` integer, required
    - `publication_id` integer, required — Identifier of the underlying publication. Posts that were also sent as broadcasts share the same `publication_id` — use it to match a post to its broadcast via `GET /v4/broadcasts`.
    - `created_at` string, required
    - `title` string, required
    - `slug` string, nullable, required
    - `description` unknown, required
    - `meta_description` unknown, required
    - `status` string, required
    - `published_at` string, nullable, required
    - `sent_at` string, nullable, required
    - `thumbnail_alt` unknown, required
    - `thumbnail_url` unknown, required
    - `is_paid` boolean, required
    - `public_url` string, nullable, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)