Skip to main content
GET
/
v1
/
knowledge
/
{kb_id}
/
documents
Get Knowledge Base Documents
curl --request GET \
  --url https://api.xpander.ai/v1/knowledge/{kb_id}/documents \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "document_url": "<string>",
      "kb_id": "<string>",
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "per_page": 123,
  "total_pages": 123
}
Retrieve all documents stored in a specific knowledge base with pagination support. This endpoint returns document metadata including IDs and URLs.

​
Path Parameters

​
kb_id
string
required
Unique identifier of the knowledge base (UUID format)

​
Query Parameters

​
page
integer
default:1
Page number (starting from 1)
​
per_page
integer
default:20
Items per page (maximum 50)

​
Response

​
items
array
Array of document objects
​
total
integer
Total number of documents in the knowledge base
​
page
integer
Current page number
​
per_page
integer
Number of items per page
​
total_pages
integer
Total number of pages available

​
Example Request

curl -X GET -H "x-api-key: YOUR_API_KEY" \
  "https://api.xpander.ai/v1/knowledge/e21563bd-7c02-4f8f-9520-8c854f5c2ee6/documents?page=1&per_page=10"

​
Example Response

{
  "items": [
    {
      "kb_id": "e21563bd-7c02-4f8f-9520-8c854f5c2ee6",
      "id": "c7e44aac-e347-481d-bef8-8f230adf1a74",
      "name": null,
      "document_url": "https://svc-sb.app.xpander.ai/storage/v1/object/public/kb_files/e21563bd-7c02-4f8f-9520-8c854f5c2ee6/1753618104807-ztna-vs-vpn-side-by-side-comparison.md"
    },
    {
      "kb_id": "e21563bd-7c02-4f8f-9520-8c854f5c2ee6",
      "id": "d297e31f-ff36-457c-a2e7-254965c366fc",
      "name": null,
      "document_url": "https://svc-sb.app.xpander.ai/storage/v1/object/public/kb_files/e21563bd-7c02-4f8f-9520-8c854f5c2ee6/1753618103245-whitelisting-docs-client-processes-1.md"
    }
  ],
  "total": 278,
  "page": 1,
  "per_page": 10,
  "total_pages": 28
}

​
Notes

  • Documents are returned in the order they were added to the knowledge base
  • The document_url field contains the full URL to access the document file
  • Use this endpoint to audit what documents are in a knowledge base
  • Combine with [Get Document](/API reference/v1/knowledge/get-document) to retrieve full document details

​
See Also

  • [Add Documents](/API reference/v1/knowledge/add-documents) - Add new documents to a knowledge base
  • [Get Document](/API reference/v1/knowledge/get-document) - Get detailed information about a specific document
  • [Delete Document](/API reference/v1/knowledge/delete-document) - Remove a document from a knowledge base
  • [Search Knowledge Base](/API reference/v1/knowledge/search-knowledge-base) - Search for content within documents

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
kb_id
string
required

Query Parameters

​
page
integer
default:1

Page number (starting from 1)

Required range: x >= 1
​
per_page
integer
default:20

Items per page (max 50)

Required range: 1 <= x <= 50

Response

Successful Response

​
items
KnowledgeBaseDocumentItem · object[]
required
​
total
integer
required
​
page
integer
required
​
per_page
integer
required
​
total_pages
integer
required