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

# Get File



## OpenAPI

````yaml get /files/{fileId}
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/{fileId}:
    get:
      tags:
        - Files
      summary: Get File
      parameters:
        - in: path
          name: fileId
          required: true
          schema:
            type: string
          description: Unique identifier of the file.
      responses:
        '200':
          description: File retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  file:
                    $ref: '#/components/schemas/File'
        '404':
          description: File not found.
        '500':
          description: Error fetching file.
      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)
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````