---
title: "List articles"
method: GET
path: "/knowledgebases/{knowledgebase_slug}/articles"
tags: ["Knowledge Base"]
---

# List articles

`GET /knowledgebases/{knowledgebase_slug}/articles`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/knowledgebases/{knowledgebase_slug}/articles`
- Auth: HTTP bearer

List articles.

Personal access token only. The API supports a second, partner-issued token class that is not part of the public surface. This endpoint does not accept that class.

## Path parameters

- `knowledgebase_slug` string, required

## Response `200`

Success.

- KnowledgeBaseArticleList: A paginated list of published articles in a knowledge base.
  - `data` KnowledgeBaseArticleListItem[], required
    - `id` string
    - `title` string
    - `slug` string
    - `excerpt` string, nullable
    - `published_at` string, date-time, nullable
    - `knowledgebase` object: The knowledge base the article belongs to.
      - `id` string
      - `name` string
      - `slug` string
      - `visibility` string, nullable
  - `links` PaginationLinks
    - `first` string, uri, nullable
    - `last` string, uri, nullable
    - `prev` string, uri, nullable
    - `next` string, uri, nullable
  - `meta` PaginationMeta: Standard (counting) paginator meta block.
    - `current_page` integer
    - `from` integer, nullable
    - `last_page` integer
    - `per_page` integer
    - `to` integer, nullable
    - `total` integer
    - `path` string, uri
    - `links` object[]: Rendered paginator links: the numbered pages plus the previous/next controls (whose `url` and `page` are null when unavailable).
      - `url` string, uri, nullable
      - `label` string
      - `page` integer, nullable
      - `active` boolean

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api.md) - [All operations](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/revisions/dce9c632a018?raw)