---
title: "Get folders"
method: GET
path: "/knowledge-base/1/folders"
tags: ["customer-engagement", "knowledge-base", "knowledge-base-folders"]
---

# Get folders

`GET /knowledge-base/1/folders`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/knowledge-base/1/folders`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Returns a paginated list of folders. Optionally filter by folder name or category. Results are sorted by name in ascending order by default.

## Query parameters

- `name` string
- `categoryId` string, uuid
- `page` integer
- `size` integer
- `sort` string

## Response `200`

Folders returned successfully

- 09ef6171198229ad9a73a413d2271afa3ba31b9abbd6cd8a0cc9563fd721f1edPageFolderItemResponse
  - `results` 09ef6171198229ad9a73a413d2271afa3ba31b9abbd6cd8a0cc9563fd721f1edFolderItemResponse[], required: The list of the results for this page.
    - `name` string, required: Name of the folder.
    - `id` string, uuid, required: Unique identifier of the folder.
    - `breadCrumbList` string[], required: Breadcrumb path from root to this folder.
  - `paging` 09ef6171198229ad9a73a413d2271afa3ba31b9abbd6cd8a0cc9563fd721f1edPageInfo, required: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)