Skip to main content
GET
/
api
/
knowledge-base
List Knowledge Bases
curl --request GET \
  --url https://api.getello.ai/api/knowledge-base \
  --header 'X-API-Key: <api-key>'
{
  "status": 200,
  "message": "Knowledge bases retrieved successfully",
  "data": [
    {
      "_id": "684035a7dba9d9c2aa583d93",
      "workspaceId": "683ea9dbea7c50a81708dae7",
      "name": "Test",
      "description": "Updated description of the knowledge base 1",
      "type": "documents",
      "sources": [
        {
          "_id": "684035a7dba9d9c2aa583d94",
          "type": "pdf",
          "name": "sample1.pdf",
          "url": "https://voicemart-assets.s3.amazonaws.com/683ea9dbea7c50a81708dae7/documents/sample1.pdf",
          "status": "completed",
          "metadata": {
            "fileName": "sample1.pdf",
            "fileType": "pdf",
            "fileKey": "683ea9dbea7c50a81708dae7/documents/sample1.pdf"
          }
        }
      ],
      "status": true,
      "createdAt": "2025-06-04T12:01:43.682000",
      "updatedAt": "2025-06-04T13:58:16.585000"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 12,
    "totalPages": 2,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
page
integer

Page number for pagination

Example:

1

​
limit
integer

Number of results per page

Example:

20

​
search
string

Search keyword to filter knowledge bases by name or description

Example:

"link"

​
start_date
string<date-time>

Filter results created after this date (ISO 8601 string)

Example:

"2025-06-01T00:00:00Z"

​
end_date
string<date-time>

Filter results created before this date (ISO 8601 string)

Example:

"2025-06-30T23:59:59Z"

​
sortBy
string

Field to sort by (e.g., name, createdAt)

Example:

"createdAt"

​
sortOrder
enum<string>

Sort order, either asc or desc

Available options:
asc,
desc
Example:

"desc"

Response

Knowledge bases retrieved successfully