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

# Get file status

> Return the processing status of a file. Poll this endpoint until `status` is `ready` before issuing search or chat queries that expect the file's content.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/files/{file_id}/status
openapi: 3.1.0
info:
  title: Memic API
  description: >-
    Memic is a memory layer for AI applications. The Memic API lets you ingest
    documents, run semantic search and chat, and manage prompts — all scoped to
    an environment via a single API key.
  version: 1.0.0
servers:
  - url: https://api.memic.ai
    description: Production
security:
  - MemicApiKey: []
tags:
  - name: Endpoints
    description: All 10 Memic API endpoints.
paths:
  /api/v1/files/{file_id}/status:
    get:
      tags:
        - Endpoints
      summary: Get file status
      description: >-
        Return the processing status of a file. Poll this endpoint until
        `status` is `ready` before issuing search or chat queries that expect
        the file's content.
      operationId: getFileStatus
      parameters:
        - name: file_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: File Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileStatusResponseDTO'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - MemicApiKey: []
components:
  schemas:
    FileStatusResponseDTO:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        name:
          type: string
          title: Name
        original_filename:
          type: string
          title: Original Filename
        status:
          $ref: '#/components/schemas/FileStatus'
        project_id:
          type: string
          format: uuid4
          title: Project Id
        environment_id:
          anyOf:
            - type: string
              format: uuid4
            - type: 'null'
          title: Environment Id
        environment_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Environment Slug
        folder_id:
          anyOf:
            - type: string
              format: uuid4
            - type: 'null'
          title: Folder Id
        folder_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Folder Name
        blob_storage_path:
          type: string
          title: Blob Storage Path
        is_converted:
          type: boolean
          title: Is Converted
        converted_file_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Converted File Path
        enriched_file_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Enriched File Path
        total_chunks:
          type: integer
          title: Total Chunks
        total_embeddings:
          type: integer
          title: Total Embeddings
          default: 0
        embedding_dimension:
          anyOf:
            - type: integer
            - type: 'null'
          title: Embedding Dimension
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        conversion_started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Conversion Started At
        conversion_completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Conversion Completed At
        parsing_started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Parsing Started At
        parsing_completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Parsing Completed At
        chunking_started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Chunking Started At
        chunking_completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Chunking Completed At
        embedding_started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Embedding Started At
        embedding_completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Embedding Completed At
        conversion_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Conversion Duration Seconds
        parsing_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Parsing Duration Seconds
        chunking_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Chunking Duration Seconds
        embedding_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Embedding Duration Seconds
        total_processing_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Processing Duration Seconds
        estimated_remaining_time_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Estimated Remaining Time Seconds
        estimated_remaining_time_display:
          anyOf:
            - type: string
            - type: 'null'
          title: Estimated Remaining Time Display
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        file_metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: File Metadata
      type: object
      required:
        - id
        - name
        - original_filename
        - status
        - project_id
        - blob_storage_path
        - is_converted
        - total_chunks
        - created_at
        - updated_at
      title: FileStatusResponseDTO
      description: Detailed status response for file processing.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FileStatus:
      type: string
      enum:
        - uploading
        - uploaded
        - upload_failed
        - conversion_started
        - conversion_complete
        - conversion_failed
        - parsing_started
        - parsing_complete
        - parsing_failed
        - chunking_started
        - chunking_complete
        - chunking_failed
        - embedding_started
        - embedding_complete
        - embedding_failed
        - ready
      title: FileStatus
      description: Enum for file processing status.
    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:
    MemicApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Memic API key. Every key is bound to exactly one environment — get one
        from the Memic dashboard under API Keys.

````