---
title: "List blog posts"
method: GET
path: "/blog/posts"
tags: ["Blog posts"]
---

# List blog posts

`GET /blog/posts`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/blog/posts`
- Auth: HTTP bearer

Returns a list of blog posts for the account, most recently updated first. Filter by a single `status`.

## Query parameters

- `cursor` string
- `limit` integer
- `status` 'draft' | 'scheduled' | 'published'

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` BlogPostSummary[], required
    - `id` string, required: Unique identifier for the object. Use this value as the `{id}` path parameter for the blog-post endpoints (e.g. `GET /v1/blog/posts/{id}`).
    - `object` 'blog_post', required
    - `title` string, required
    - `slug` string, required
    - `status` string, required
    - `visibility` string, required
    - `type` string, required
    - `featured` boolean, required
    - `authorIds` string[], required
    - `tagIds` string[], required
    - `coverUrl` string, nullable, required
    - `ogImageUrl` string, nullable, required
    - `featureImageAlt` string, nullable, required
    - `featureImageCaption` string, nullable, required
    - `customExcerpt` string, nullable, required
    - `readingTimeMin` number, nullable, required
    - `seoTitle` string, nullable, required
    - `seoDescription` string, nullable, required
    - `canonicalUrl` string, nullable, required
    - `publishedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, nullable, required

## Other responses

- `400`: The request was malformed.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `400` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/blog/posts/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)