---
title: "List posts"
method: GET
path: "/cms/blogs/2026-09/posts/cursor"
tags: ["Basic"]
---

# List posts

`GET /cms/blogs/2026-09/posts/cursor`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/blogs/2026-09/posts/cursor`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

Retrieve a list of blog posts with optional filtering and sorting capabilities. This endpoint supports pagination and allows you to specify date ranges for creation and update times, as well as sorting preferences. It is useful for obtaining an overview of blog posts, including archived ones if desired.

## Query parameters

- `after` string
- `archived` boolean
- `createdAfter` string, date-time
- `createdAt` string, date-time
- `createdBefore` string, date-time
- `limit` integer
- `property` string
- `sort` string[]
- `updatedAfter` string, date-time
- `updatedAt` string, date-time
- `updatedBefore` string, date-time

## Response `200`

successful operation

- CursorPagedResultBlogPostLong

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `062fc4c57ddc`: 1 info
  - api operation id `get-/cms/blogs/2026-09/posts/cursor_/cms/blogs/2026-09/posts/cursor` removed and replaced with `get-/cms/blogs/2026-09/posts/cursor_/cms/blogs/v3/posts/cursor`
- **2026-09-03** (2026-09) `64f654adebd9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/cms-posts/changes/cms/blogs/2026-09/posts/cursor/get.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-posts.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-posts/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-posts/revisions/12cef4e9cdd5?raw)