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

# Get Document

> Fetch a document's details.

**Args**:
    `document_id`: Document ID (path parameter)

**Raises**:
    - `404`: If the document is not found or doesn't belong to the user



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json get /api/v3/documents/{document_id}
openapi: 3.1.0
info:
  title: Nugen Intelligence API
  description: >+
    Nugen Intelligence: Powering Specialized Intelligence At Scale.


    **Need an API key?** Sign up, log in to the platform and generate an API
    key.


    **Need help?** Sign up, log in to the platform and raise a support ticket.


    **What this API does.** Align models to your domain corpus and run them with

    confidence. Train-time alignment builds domain-aligned adaptors through

    proprietary methods spanning pre-training, supervised and reinforcement

    stages. Inference-time alignment quantifies uncertainty across the full

    generation trajectory, producing confidence scores and keeping every

    response on domain.


    **Workflow.** Upload documents, create or generate a benchmark, create an

    alignment project, receive an aligned model id. That one id serves chat

    completions, completions, embeddings and reranking, and its embeddings carry

    your domain's representation space, making retrieval domain aware. You
    define the success

    criteria for your domain; the platform handles the deep learning, the GPUs

    and the data preparation.


    **Authentication.** Every endpoint requires an API key sent as a Bearer
    token:

    `Authorization: Bearer <api_key>`.

  contact:
    name: Nugen Intelligence - Customer Support
    url: https://nugen.in/signup
    email: support@nugen.in
  version: 25.4.20
servers:
  - url: https://api.nugen.in
    description: Production
security: []
paths:
  /api/v3/documents/{document_id}:
    get:
      tags:
        - Documents
      summary: Get Document
      description: |-
        Fetch a document's details.

        **Args**:
            `document_id`: Document ID (path parameter)

        **Raises**:
            - `404`: If the document is not found or doesn't belong to the user
      operationId: get_document
      parameters:
        - name: document_id
          in: path
          required: true
          schema:
            type: string
            title: Document Id
      responses:
        '200':
          description: >-
            Returns the document's full record: document_id, name, filename,
            type, size, status, categories, uploader, and timestamps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentsDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    DocumentsDetail:
      properties:
        document_id:
          type: string
          title: Document Id
          description: Unique identifier for the document
          examples:
            - document_01k4x9m2p7q3r5s8
            - document_01k4x9m2p7q3r5s9
        document_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Name
          description: >-
            Display name of the document. Defaults to the document id if not set
            at upload.
          examples:
            - Customer Support Guide
        filename:
          type: string
          title: Filename
          description: Original filename of the uploaded document
          examples:
            - product_catalog.docx
            - training_manual.txt
        type:
          type: string
          title: Type
          description: MIME type of the document
          examples:
            - text/plain
        size:
          type: integer
          minimum: 0
          title: Size
          description: File size in bytes
          examples:
            - 2548736
            - 1024000
            - 512000
        status:
          $ref: '#/components/schemas/DocumentStatus'
          description: >-
            Current processing status of the document (PROCESSING, READY,
            FAILED)
        categories:
          items:
            type: string
          type: array
          title: Categories
          description: >-
            List of category tags assigned to the document for organization and
            retrieval
          examples:
            - - customer_support
              - documentation
            - - products
              - sales
            - - legal
              - compliance
        uploader:
          type: string
          title: Uploader
          description: Email/username of the user who uploaded the document
          examples:
            - user@example.com
            - admin@example.com
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: Timestamp when the document was created
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
          description: Timestamp when processing completed; null while still running
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
          description: Timestamp of the last status change
        progress:
          anyOf:
            - type: number
            - type: 'null'
          title: Progress
          description: Completion progress, 0.0 to 100.0. Not wired up yet, always null.
        eta_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Eta Seconds
          description: Estimated time remaining in seconds. Not wired up yet, always null.
      type: object
      required:
        - document_id
        - filename
        - type
        - size
        - status
        - categories
        - uploader
      title: DocumentInfo
      description: |-
        One document's full record: everything on its status and list rows,
        plus filename, type, size and uploader found nowhere else.
      examples:
        - categories:
            - customer_support
            - documentation
          completed_at: '2024-01-15T10:31:00Z'
          created_at: '2024-01-15T10:30:00Z'
          document_id: document_01k4x9m2p7q3r5s8
          document_name: Customer Support Guide
          filename: customer_support_guide.txt
          size: 2548736
          status: READY
          type: text/plain
          updated_at: '2024-01-15T10:31:00Z'
          uploader: user@example.com
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DocumentStatus:
      type: string
      enum:
        - PROCESSING
        - READY
        - FAILED
      title: DocumentStatus
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````