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

# Upload Documents Status

> Check the upload status of a document task.

Use this endpoint to monitor the progress of a document upload after receiving
a task ID from the upload endpoint. The status indicates whether the document
is still being uploaded, has completed successfully, or has failed.

**Args**:
    `id`: Task ID returned from the upload endpoint (path parameter)
    
**Returns**:
    `dict`: Upload status information containing:
        - status: Current upload status ("PROCESSING", "READY", "FAILED")
        - document_id: Document ID once upload is COMPLETED (null if still uploading)

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

**Example**:
    **Request**:
        ```GET /api/v3/documents/upload-status/task-abc123-def456
            Headers: {"Authorization": "Bearer <api_key>"}
        ```
    **Response**:
    ```
        {
            "status": "READY",
            "document_id": "doc-xyz789"
        }
    ```



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json get /api/v3/documents/{id}
openapi: 3.1.0
info:
  title: Nugen Intelligence API
  description: 'Nugen Intelligence : Powering Specialized Intelligence At Scale'
  version: 25.4.20
servers: []
security: []
paths:
  /api/v3/documents/{id}:
    get:
      tags:
        - Documents
      summary: Upload Documents Status
      description: >-
        Check the upload status of a document task.


        Use this endpoint to monitor the progress of a document upload after
        receiving

        a task ID from the upload endpoint. The status indicates whether the
        document

        is still being uploaded, has completed successfully, or has failed.


        **Args**:
            `id`: Task ID returned from the upload endpoint (path parameter)
            
        **Returns**:
            `dict`: Upload status information containing:
                - status: Current upload status ("PROCESSING", "READY", "FAILED")
                - document_id: Document ID once upload is COMPLETED (null if still uploading)

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

        **Example**:
            **Request**:
                ```GET /api/v3/documents/upload-status/task-abc123-def456
                    Headers: {"Authorization": "Bearer <api_key>"}
                ```
            **Response**:
            ```
                {
                    "status": "READY",
                    "document_id": "doc-xyz789"
                }
            ```
      operationId: get_upload_status
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            title: Id
      responses:
        '200':
          description: >-
            Returns the upload status for a given unique ID received from upload
            document endpoint. This endpoint allows clients to check the
            progress of a document upload after initiating it via the upload
            endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUploadStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    GetUploadStatusResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Current upload status: PROCESSING, READY, FAILED, or unknown'
          example: READY
        document_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Id
          description: >-
            Document ID once the upload is READY; null while still uploading or
            if failed
          example: doc-xyz789
      type: object
      required:
        - status
      title: GetUploadStatusResponse
      examples:
        - document_id: doc-xyz789
          status: READY
        - status: PROCESSING
        - status: FAILED
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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

````