---
title: "List articles"
method: GET
path: "/v3/cms/articles"
tags: ["CMS"]
---

# List articles

`GET /v3/cms/articles`

Returns a paginated list of articles for the team with status, SEO scores, publish dates, and metadata. Does not include full article body content.

## Query parameters

- `teamId` string
- `page` string
- `per_page` string
- `status` 'draft' | 'processing' | 'generated' | 'scheduled' | 'published' | 'failed' | 'manual' | 'all'
- `topicId` string
- `startDate` string
- `endDate` string
- `search` string
- `sortBy` 'name' | 'status' | 'seo' | 'topic' | 'created'
- `sortDir` 'asc' | 'desc'
- `category` string
- `tag` string

## Response `200`

Default Response

- object
  - `articles` object[]
    - `slug` string
    - `topicId` string, nullable
    - `title` string, nullable
    - `status` 'draft' | 'processing' | 'generated' | 'scheduled' | 'published' | 'failed' | 'manual', nullable
    - `type` 'listicle' | 'comparison' | 'news' | 'review' | 'guide' | 'manual', nullable
    - `keywords` object[]
      - `keyword` string
      - `type` 'primary' | 'secondary'
    - `prompts` object[]
      - `prompt` string
      - `type` 'primary' | 'secondary'
      - `topic` string
    - `auditScore` number, nullable
    - `url` string, nullable
    - `cmsArticleId` string, nullable
    - `provider` string[], nullable
    - `publishedAt` string, nullable
    - `scheduledAt` string, nullable
    - `lastRefreshedAt` string, nullable
    - `cmsPostStatus` 'draft' | 'published', nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `metaData` object, nullable
    - `isPublic` boolean, nullable
    - `isPillar` boolean, nullable
    - `generating` boolean
    - `generationKind` string, nullable
    - `finalizing` boolean
    - `categories` string[]
    - `tags` string[]
  - `pagination` object
    - `page` number
    - `perPage` number
    - `total` number
    - `totalPages` number
    - `hasMore` boolean

## Other responses

- `500` — Default Response

## Changes

> 31 revisions in range; 7 could not be searched.

- **2026-08-09** `8f92b00b75d6` — 5 breaking, 3 warning, 18 info
  - the `query` request parameter `sortBy` was restricted to a list of enum values
  - the `query` request parameter `sortDir` was restricted to a list of enum values
  - the `query` request parameter `status` was restricted to a list of enum values
  - for the `query` request parameter `sortBy`, default value `created` was added
  - …22 more
- **2026-07-26** `60ff6690f93c` — 4 info
  - added the new optional `query` request parameter `category`
  - added the new optional `query` request parameter `tag`
  - added the optional property `articles/items/categories` to the response with the `200` status
  - added the optional property `articles/items/tags` to the response with the `200` status

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/cms/articles/get.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/86840800b2f3/schema)