BizKitHub
DocsAPI ReferencePost Category/bff/post-category/list
getPost CategoryAdmin BFF

/bff/post-category/list

Returns a paginated list of all post categories for the organisation. Supports data grid query parameters for filtering and pagination.

Post CategorygetBffPost-categoryList

Parameters

3 query

Query parameters

· 3
pagestringOptional

Page number (1-based) for pagination.

Example1
limitstringOptional

Maximum items per page (1–500, default 50).

Example50
mainCategoryCodestringOptional

Filter by main category code.

Exampleblog

Response schema

1 status code documented

200SuccessPaginated list of post categories.
itemsobject[]Required

Array of category items matching the query criteria.

Each array item:

Single category item in the list.

idstringRequired

Category external ID (16-char unique identifier).

Exampleabc123def456ghij
parentIdstringOptional

External ID of the parent category. Omitted for top-level categories.

Exampleabc123def456ghij
titlestringRequired

Localized category name, truncated to 140 characters for list view.

ExampleTech News
insertedDateDate | string | string | numberRequired

Date when the category was created.

One of 4:
Variant 1
Date

Date when the category was created.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
activebooleanRequired

Whether the category is currently active.

Exampletrue
postCountnumberRequired

Total number of posts in this category and all its descendant categories (recursive count).

Example42
itemCountnumberRequired

Total number of categories matching the query (before pagination).

Example15

Response example

application/json
{
  "items": [
    {
      "id": "abc123def456ghij",
      "parentId": "abc123def456ghij",
      "title": "Tech News",
      "active": true,
      "postCount": 42
    }
  ],
  "itemCount": 15
}

Request example

GET /bff/post-category/list

get
curl -X GET "https://api.bizkithub.com/bff/post-category/list?page=1&limit=50&mainCategoryCode=blog" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key