Get Document

Endpoint

GET /apiops/projects/{projectName}/knowledge-bases/{kbName}/documents/{documentId}/

Authentication

Requires a Personal API Access Token.

Header

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer {token}	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
kbName	string	Yes	Knowledge base name (parent, resolved by name)
documentId	string	Yes	Document id (documents are referenced by id, not name)

Query Parameters

None

Response

Success Response (200 OK)

{
  "status": "SUCCESS",
  "resultList": [
    {
      "id": "6651b3c4e4b0c3a2d1f0aaaa",
      "knowledgeBaseId": "6650a1f2e4b0c3a2d1f09876",
      "projectId": "6650a1f2e4b0c3a2d1f01234",
      "fileName": "user-guide.pdf",
      "contentType": "application/pdf",
      "sizeBytes": 248193,
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "status": "INDEXED",
      "chunkCount": 42,
      "uploadedAt": "2026-07-11T10:05:00Z",
      "errorMessage": null
    }
  ],
  "resultCount": 1
}

Response Fields

Field	Type	Description
status	string	Response status: SUCCESS or FAILURE
resultList	array	Single-element list containing the document object
resultCount	integer	Number of documents returned (1)

Document Object Fields

Field	Type	Description
id	string	Server-generated document identifier
knowledgeBaseId	string	Internal id of the parent knowledge base
projectId	string	Internal id of the owning project
fileName	string	Original uploaded file name
contentType	string	MIME type detected on upload
sizeBytes	integer	File size in bytes
sha256	string	SHA-256 content hash (used for deduplication)
status	string	Processing status: PENDING, CHUNKED, INDEXED, ERROR
chunkCount	integer	Number of indexed chunks (read-only)
uploadedAt	string	ISO-8601 upload timestamp
errorMessage	string	Error detail when status is ERROR; null otherwise

Document Status Values

• PENDING - Uploaded, not yet processed
• CHUNKED - Text split into chunks; embedding generation in progress
• INDEXED - Chunks embedded and upserted to the VectorDB; queryable
• ERROR - Processing failed at some stage; see errorMessage

EnumStatus

• SUCCESS - Operation successful
• FAILURE - Operation failed

Error Response (400 Bad Request)

{
  "status": "FAILURE",
  "resultMessage": "Document id can not be empty!"
}

or

{
  "status": "FAILURE",
  "resultMessage": "Knowledge base (name: product-docs) was not found!"
}

Error Response (401 Unauthorized)

{
  "status": "FAILURE",
  "resultMessage": "Token is not valid!"
}

cURL Example

curl -X GET \
  "https://demo.apinizer.com/apiops/projects/MyProject/knowledge-bases/product-docs/documents/6651b3c4e4b0c3a2d1f0aaaa/" \
  -H "Authorization: Bearer YOUR_TOKEN"

Notes and Warnings

• Id-Based (Deliberate Exception): Documents are addressed by documentId, not by name, because filenames are not unique within a knowledge base. The parent knowledge base is still resolved by kbName first.
• Ownership Enforcement: The document is resolved by documentId AND knowledgeBaseId AND projectId together, so a document id belonging to a different knowledge base or project is unreachable.
• Internal Storage Reference Hidden: The document's internal storage reference (gridFsFileId) is intentionally excluded.
• Permissions: Requires AI_DEVELOPMENT + VIEW permission in the project.

Related Documentation

• List Documents - Discover document ids
• Upload Document - Add a document to the knowledge base
• Delete Document - Remove a document and its vectors
• Knowledge Bases API - Resource overview