Retrieve all articles
Retrieve a list of articles from the knowledge base. This endpoint allows filtering and sorting articles based on creation and update timestamps, state, language, and other attributes. It supports pagination and can include additional details such as the article body and translations.
Supported products
Supported products
Required scopes
Required scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
A pagination cursor. Pass the value from the previous response’s paging.next.after to retrieve the next page.
Filter articles based on whether they are archived in the dashboard.
Filter to articles belonging to the specified category ID(s). Accepts multiple values, repeated as separate query parameters.
Filter to articles created after the specified date-time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).
Filter articles to those with this exact creation timestamp. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).
Filter to articles created before the specified date-time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).
A boolean indicating whether to include each article’s HTML content (the body field) in the response. Defaults to true.
A boolean indicating whether to include a summary of each article’s translations (id, title, and state per language) in the response. Defaults to true.
Filter to articles belonging to the specified knowledge base ID(s). Accepts multiple values, repeated as separate query parameters.
Filter articles by a specific language. Accepts an ISO 639 language code (e.g., en, es), optionally with a region subtag (e.g., en-US). Accepts multiple values, repeated as separate query parameters.
The number of results to display per page. Default is 25, maximum is 100.
Specify how to sort results. Accepts name, createdAt, or updatedAt; prefix a field with - for descending order (e.g., -createdAt). Defaults to createdAt descending (newest first).
Filter to articles in the specified state. Accepted values are DRAFT or PUBLISHED.
Filter to articles updated after the specified date-time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).
Filter articles to those with this exact update timestamp. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).
Filter to articles updated before the specified date-time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).