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

# List Files



## OpenAPI

````yaml get /files
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.callhq.ai/api
security:
  - apiKeyAuth: []
paths:
  /files:
    get:
      tags:
        - Files
      summary: List Files
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: Page number for pagination.
        - in: query
          name: limit
          schema:
            type: integer
            default: 10
          description: Maximum number of files to return per page.
      responses:
        '200':
          description: List of files retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  files:
                    type: array
                    items:
                      $ref: '#/components/schemas/File'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
        '500':
          description: Error fetching files.
      security:
        - apiKeyAuth: []
components:
  schemas:
    File:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the file
        externalId:
          type: string
          description: External identifier for the file
        name:
          type: string
          description: Original name of the file
        integrationId:
          type: string
          description: ID of the integration this file belongs to
        url:
          type: string
          description: URL to access the file
        bytes:
          type: integer
          description: Size of the file in bytes
        object:
          type: string
          description: Object type identifier
        purpose:
          type: string
          description: Purpose of the file (e.g., 'assistant')
        mimetype:
          type: string
          description: MIME type of the file
        bucket:
          type: string
          description: Storage bucket name
        path:
          type: string
          description: Storage path within the bucket
        status:
          type: string
          description: Processing status of the file
        parsedTextUrl:
          type: string
          description: URL to access the parsed text content
        parsedTextBytes:
          type: string
          description: Size of parsed text in bytes
        organizationId:
          type: string
          description: ID of the organization that owns the file
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp
        organization:
          type: object
          properties:
            id:
              type: string
              description: Organization identifier
            name:
              type: string
              description: Organization name
        integration:
          type: object
          nullable: true
          description: Integration details (can be null)
    Pagination:
      type: object
      properties:
        total:
          type: integer
          description: Total number of items
        page:
          type: integer
          description: Current page number
        limit:
          type: integer
          description: Number of items per page
        totalPages:
          type: integer
          description: Total number of pages
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````