curl --request GET \
--url https://api.sigmamind.ai/v1/knowledge-bases \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sigmamind.ai/v1/knowledge-bases"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sigmamind.ai/v1/knowledge-bases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sigmamind.ai/v1/knowledge-bases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sigmamind.ai/v1/knowledge-bases"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sigmamind.ai/v1/knowledge-bases")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sigmamind.ai/v1/knowledge-bases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"kbId": "kb_6sbr3tbMX757M0VD",
"name": "Support FAQs",
"files": [
{
"documentId": "doc_a1b2c3d4e5f67890",
"type": "url",
"content": "https://docs.example.com/guide"
}
],
"createdAt": "2026-05-06T11:15:02.073Z",
"updatedAt": "2026-05-06T11:15:02.073Z"
}
],
"page": 0,
"size": 20,
"totalCount": 125,
"totalPages": 7,
"hasNext": true,
"hasPrevious": false
}{
"error": "Bad Request",
"message": "Invalid request parameters",
"path": "/v1/knowledge-bases",
"status": 400,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Unauthorized",
"message": "X-API-Key is missing or invalid",
"path": "/v1/knowledge-bases",
"status": 401,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Forbidden",
"message": "Access denied for this resource",
"path": "/v1/knowledge-bases",
"status": 403,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Not Found",
"message": "The requested resource was not found",
"path": "/v1/knowledge-bases",
"status": 404,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Payload Too Large",
"message": "An uploaded file exceeds the per-file size limit (25 MB).",
"path": "/v1/knowledge-bases",
"status": 413,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Unsupported Media Type",
"message": "Uploaded file type is not supported. Allowed: PDF, TXT, HTML, Markdown, DOCX.",
"path": "/v1/knowledge-bases",
"status": 415,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Internal Server Error",
"message": "Something went wrong on the server",
"path": "/v1/knowledge-bases",
"status": 500,
"timestamp": "2026-05-14T14:27:22.325Z"
}List knowledge bases
Returns a paginated list of knowledge bases for the account, sorted by most recently updated. Each item includes its sources and timestamps. Use page and size for pagination.
curl --request GET \
--url https://api.sigmamind.ai/v1/knowledge-bases \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sigmamind.ai/v1/knowledge-bases"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sigmamind.ai/v1/knowledge-bases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sigmamind.ai/v1/knowledge-bases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sigmamind.ai/v1/knowledge-bases"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sigmamind.ai/v1/knowledge-bases")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sigmamind.ai/v1/knowledge-bases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"kbId": "kb_6sbr3tbMX757M0VD",
"name": "Support FAQs",
"files": [
{
"documentId": "doc_a1b2c3d4e5f67890",
"type": "url",
"content": "https://docs.example.com/guide"
}
],
"createdAt": "2026-05-06T11:15:02.073Z",
"updatedAt": "2026-05-06T11:15:02.073Z"
}
],
"page": 0,
"size": 20,
"totalCount": 125,
"totalPages": 7,
"hasNext": true,
"hasPrevious": false
}{
"error": "Bad Request",
"message": "Invalid request parameters",
"path": "/v1/knowledge-bases",
"status": 400,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Unauthorized",
"message": "X-API-Key is missing or invalid",
"path": "/v1/knowledge-bases",
"status": 401,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Forbidden",
"message": "Access denied for this resource",
"path": "/v1/knowledge-bases",
"status": 403,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Not Found",
"message": "The requested resource was not found",
"path": "/v1/knowledge-bases",
"status": 404,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Payload Too Large",
"message": "An uploaded file exceeds the per-file size limit (25 MB).",
"path": "/v1/knowledge-bases",
"status": 413,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Unsupported Media Type",
"message": "Uploaded file type is not supported. Allowed: PDF, TXT, HTML, Markdown, DOCX.",
"path": "/v1/knowledge-bases",
"status": 415,
"timestamp": "2026-05-14T14:27:22.325Z"
}{
"error": "Internal Server Error",
"message": "Something went wrong on the server",
"path": "/v1/knowledge-bases",
"status": 500,
"timestamp": "2026-05-14T14:27:22.325Z"
}Authorizations
Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.
Query Parameters
Zero-based page number to retrieve. Use 0 for the first page. Must be 0 or greater.
Number of knowledge bases to return per page. Must be 1 or greater. Defaults to 10.
Response
Paginated knowledge bases for this account (may be an empty page).
Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
List of items for the current page. Contains up to 'size' number of records.
Show child attributes
Show child attributes
Current page number (0-based index). Indicates which page of results is being returned.
0
Number of items requested per page. Determines the maximum size of the 'data' list.
20
Total number of records available across all pages. Useful for calculating pagination on the client side.
125
Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
7
Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
true
Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.
false