Skip to main content
GET
/
v1
/
articles
/
categories
List Categories
curl --request GET \
  --url https://api.siit.io/v1/articles/categories \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "count": 123,
    "current_page": 123,
    "next_page_link": "<string>",
    "per_page": 20,
    "previous_page_link": "<string>",
    "total": 123
  },
  "results": [
    {
      "uid": "<string>",
      "name": "<string>",
      "parent": "<string>"
    }
  ]
}

​
Usage

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
expand[]
string[]

Fields to expand into full objects. Example: ?expand[]=assignee_admin&expand[]=tags

​
page
integer

The current page

​
per_page
integer

Number of results retrieved per page.

​
parent_category
string

Return only categories whose parent matches this UID. Useful to fetch the direct children of a given category. Cannot be combined with root_only.

​
root_only
boolean
default:false

When true, return only top-level categories (those without a parent). Cannot be combined with parent_category.

Response

200 - application/json

Successful

​
meta
object
​
results
object[]