Skip to main content
GET
Retrieve all categories

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

cms.knowledge_base.settings.read
cms.knowledge_base.articles.publish
cms.knowledge_base.articles.write
cms.knowledge_base.articles.read
cms.knowledge_base.settings.write

Query Parameters

after
string

A pagination cursor. Pass the value from the previous response’s paging.next.after to retrieve the next page.

createdAfter
string<date-time>

Filter categories created after the specified date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

createdAt
string<date-time>

Filter categories to those with this exact creation date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

createdBefore
string<date-time>

Filter to categories created before the specified date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

knowledgeBaseIds
string[]

Filter categories by specific knowledge base IDs. Accepts multiple values, repeated as separate query parameters.

language
string

Filter categories by a specific language. Accepts an ISO 639 language code (e.g., en, es), optionally with a region subtag (e.g., en-US).

limit
integer<int32>

The number of results to display per page. Default is 25; maximum is 100.

parentCategoryIds
string[]

Filter categories by specific parent category IDs. Accepts multiple values, repeated as separate query parameters.

sort
string[]

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).

updatedAfter
string<date-time>

Filter to categories updated after the specified date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

updatedAt
string<date-time>

Filter categories to those with this exact update date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

updatedBefore
string<date-time>

Filter to categories updated before the specified date and time. Accepts an ISO-8601 timestamp (e.g., 2026-09-20T00:00:00Z) or a plain date (e.g., 2026-09-20).

Response

successful operation

results
object[]
required

The categories in this page of results, as an array of Category objects.

paging
object
Last modified on September 28, 2026