---
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` string
- `topicId` string
- `startDate` string
- `endDate` string
- `search` string
- `sortBy` string
- `sortDir` string
- `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', nullable
    - `type` 'news' | 'blog' | 'guide' | 'review' | 'comparison' | 'technical' | 'case-study' | 'listicle', 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

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/6e50f4761eea/schema)