> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Knowledge Base Details

> Fetch one knowledge base by ID.

<span data-api-safety-label="read-only"><Badge color="gray" size="sm" shape="pill">Read only</Badge></span>
Fetch one knowledge base by its `id`, including its name and timestamps.

## When to use this

* **Verify before attaching**: confirm a knowledge base exists and has the expected name before referencing it in `knowledge_base_ids` on [Create Agent](/docs/api-reference/v1/agents/create) or [Update Agent](/docs/api-reference/v1/agents/update).
* **Detail views**: render a knowledge base detail page in your own admin tooling.

A `404 Not Found` means the knowledge base does not exist in this workspace. See [Errors](/docs/api-reference/errors) for the standard error format.

The response describes the knowledge base resource record. Content ingestion and processing status are managed by the dashboard flow and are not promised by this v1 response schema.


## OpenAPI

````yaml GET /v1/knowledge-base/{id}
openapi: 3.0.0
info:
  title: DialNexa API
  description: Public `/v1` REST API for the DialNexa voice AI platform.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: Agents
  - name: Batch Calls
  - name: Calls
  - name: Knowledge Base
  - name: Languages
  - name: LLMs
  - name: Phone Numbers
  - name: Transcribers
  - name: Webhooks
  - name: Voices
  - name: Workflows
  - name: Workflow Leads
paths:
  /v1/knowledge-base/{id}:
    get:
      tags:
        - Knowledge Base
      summary: Get Knowledge Base Details
      description: Returns one knowledge base owned by the authenticated workspace.
      operationId: getKnowledgeBase
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Knowledge base returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeBase'
              examples:
                success:
                  summary: Successful response
                  value:
                    id: kb_abc123
                    name: Loan FAQ
                    description: Frequently asked questions for loan calls
                    file_name: loan-faq.pdf
                    status: ready
                    createdAt: '2026-07-03T10:30:00.000Z'
      security:
        - bearer: []
components:
  schemas:
    KnowledgeBase:
      type: object
      properties:
        id:
          type: string
          example: kb_abc123
          description: Signed knowledge base ID.
        name:
          type: string
          example: Loan FAQ
          maxLength: 150
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - name
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````