> ## Documentation Index > Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Get document > Returns a single document by ID, with the fields that define it. A document is a source the knowledge base retrieves from. ## OpenAPI ````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/document/{documentID} openapi: 3.0.0 info: title: Realtime description: Realtime gateway API service version: 1.0.0 contact: {} servers: - url: https://realtime-api.voiceflow.com security: [] tags: [] paths: /v1/stable/document/{documentID}: get: tags: - Document summary: Get document description: >- Returns a single document by ID, with the fields that define it. A document is a source the knowledge base retrieves from. operationId: StableDocumentController_get parameters: - name: documentID required: true in: path schema: type: string x-vf-doc: description: The ID of the knowledge base document to operate on. description: The ID of the knowledge base document to operate on. - name: projectID required: true in: query schema: type: string description: The ID of the project to operate on. - name: environmentAlias required: true in: query schema: type: string description: The alias of the environment to operate on (e.g. `main`). responses: '200': description: >- Returns one knowledge base document in full, adding its chunks and metadata to the data, status, and chunking settings the list operation reports. content: application/json: schema: $ref: '#/components/schemas/StableDocumentDetailsResponse' x-vf-doc: description: >- Returns one knowledge base document in full, adding its chunks and metadata to the data, status, and chunking settings the list operation reports. security: - token: [] components: schemas: StableDocumentDetailsResponse: type: object properties: document: $ref: '#/components/schemas/StableDocumentDetails' required: - document StableDocumentDetails: type: object properties: id: type: string data: nullable: true allOf: - $ref: '#/components/schemas/KBDocumentData' status: $ref: '#/components/schemas/KBDocumentStatus' smartChunking: nullable: true allOf: - $ref: '#/components/schemas/SmartChunking' chunks: type: array items: $ref: '#/components/schemas/KBDocumentChunk' metadata: type: array items: type: object properties: key: type: string description: The name of the metadata field. values: type: array items: type: string description: The values assigned to this metadata field. required: - key - values description: >- Metadata tags attached to the document, used to filter knowledge base retrieval at runtime. required: - id - data - status - smartChunking - chunks - metadata KBDocumentData: oneOf: - $ref: '#/components/schemas/KBDocumentUrlData' - $ref: '#/components/schemas/KBDocumentDocxData' - $ref: '#/components/schemas/KBDocumentPDFData' - $ref: '#/components/schemas/KBDocumentTextData' - $ref: '#/components/schemas/KBDocumentMarkdownData' - $ref: '#/components/schemas/KBDocumentCSVData' - $ref: '#/components/schemas/KBDocumentXLSXData' - $ref: '#/components/schemas/KBDocumentTableData' KBDocumentStatus: type: object properties: type: $ref: '#/components/schemas/KnowledgeBaseDocumentStatus' data: {} required: - type SmartChunking: type: object properties: markdownConversion: description: >- When enabled, HTML is automatically converted to markdown to generate better chunks. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' llmBasedChunks: anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' llmGeneratedQ: description: >- When enabled, an LLM will be used to generate a question based on the document context and specific chunk, then prepend it to the chunk. This enhances retrieval by aligning chunks with potential user queries. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' llmContentSummarization: description: >- When enabled, an LLM summarizes and rewrites the content, removing unnecessary information and focusing on important parts to optimize for retrieval. Limited to 15 rows per table upload. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' llmPrependContext: description: >- When enabled, an LLM generates a context summary based on the document and chunk context, and prepends it to each chunk. This improves retrieval by providing additional context to each chunk. Note: If both llmGeneratedQ and llmPrependContext are set to true, llmGeneratedQ takes precedence, and the context summarization will not be applied. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' KBDocumentChunk: type: object properties: chunkID: type: string content: type: string metadata: type: object additionalProperties: {} required: - chunkID - content KBDocumentUrlData: type: object properties: type: type: string enum: - url x-enumNames: - URL name: type: string url: type: string refreshRate: allOf: - $ref: '#/components/schemas/KnowledgeBaseDocumentRefreshRate' lastSuccessUpdate: type: string accessTokenID: type: number integrationExternalID: type: string source: allOf: - $ref: '#/components/schemas/KnowledgeBaseDocumentIntegrationType' required: - type - name - url KBDocumentDocxData: type: object properties: type: type: string enum: - docx x-enumNames: - DOCX name: type: string url: nullable: true type: string required: - type - name KBDocumentPDFData: type: object properties: type: type: string enum: - pdf x-enumNames: - PDF name: type: string url: nullable: true type: string required: - type - name KBDocumentTextData: type: object properties: type: type: string enum: - text x-enumNames: - TEXT name: type: string canEdit: type: boolean url: nullable: true type: string required: - type - name KBDocumentMarkdownData: type: object properties: type: type: string enum: - md x-enumNames: - MD name: type: string url: nullable: true type: string required: - type - name KBDocumentCSVData: type: object properties: type: type: string enum: - csv x-enumNames: - CSV name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name KBDocumentXLSXData: type: object properties: type: type: string enum: - xlsx x-enumNames: - XLSX name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name KBDocumentTableData: type: object properties: type: type: string enum: - table x-enumNames: - TABLE name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name - rowsCount KnowledgeBaseDocumentStatus: type: string enum: - ERROR - PENDING - SUCCESS - INITIALIZED x-enumNames: - ERROR - PENDING - SUCCESS - INITIALIZED KnowledgeBaseDocumentRefreshRate: type: string enum: - daily - weekly - monthly - never x-enumNames: - DAILY - WEEKLY - MONTHLY - NEVER KnowledgeBaseDocumentIntegrationType: type: string enum: - zendesk - shopify x-enumNames: - ZENDESK - SHOPIFY securitySchemes: token: scheme: bearer bearerFormat: JWT type: http description: Voiceflow bearer token ````