> ## 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>

<Info>
  **v1 only.** Knowledge bases are available on the `/v1` API. There is no legacy unversioned equivalent.
</Info>

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 REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /v1/knowledge-base/{id}:
    get:
      tags:
        - Knowledge Base
        - Knowledge Base V1
        - V1
      summary: Get Knowledge Base Details
      description: Returns one knowledge base owned by the authenticated workspace.
      operationId: KnowledgeBaseV1Controller_findOne
      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
      bearerFormat: JWT
      type: http

````