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

# List files

> Return a paginated list of files in the environment. Use the `page` and `page_size` query parameters to iterate.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/files
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:
    get:
      tags:
        - Endpoints
      summary: List files
      description: >-
        Return a paginated list of files in the environment. Use the `page` and
        `page_size` query parameters to iterate.
      operationId: listFiles
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            title: Page
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 50
            title: Page Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileListResponseDTO'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - MemicApiKey: []
components:
  schemas:
    FileListResponseDTO:
      properties:
        items:
          items:
            $ref: '#/components/schemas/FileListItemDTO'
          type: array
          title: Items
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        total_pages:
          type: integer
          title: Total Pages
      type: object
      required:
        - items
        - total
        - page
        - page_size
        - total_pages
      title: FileListResponseDTO
      description: Paginated response for file listing.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FileListItemDTO:
      properties:
        id:
          type: string
          format: uuid4
          title: Id
        name:
          type: string
          title: Name
        original_filename:
          type: string
          title: Original Filename
        size:
          type: integer
          title: Size
        mime_type:
          type: string
          title: Mime Type
        status:
          $ref: '#/components/schemas/FileStatus'
        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
        reference_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Reference 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
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        file_metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: File Metadata
        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
      type: object
      required:
        - id
        - name
        - original_filename
        - size
        - mime_type
        - status
        - total_chunks
        - created_at
        - updated_at
      title: FileListItemDTO
      description: List item DTO for file listing.
    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
    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.
  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.

````