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

# Get Files

> Get files



## OpenAPI

````yaml GET /files
openapi: 3.1.0
info:
  title: Serial
  version: '1.0'
  description: Access and control your Serial data programmatically.
  contact:
    name: Devon Copeland
    email: support@serial.io
    url: www.serial.io
  summary: Serial API
servers:
  - url: https://api.serial.io
security:
  - serial-default-security: []
tags:
  - name: AI
    description: AI Endpoints
  - name: Auth
    description: Auth Endpoints
  - name: Companies
    description: Company Endpoints
  - name: Component Instances
    description: Component Instance Endpoints
  - name: Components
    description: Component Endpoints
  - name: Datasets
    description: Dataset Endpoints
  - name: Fields
    description: Field Endpoints
  - name: Legacy
    description: Legacy Endpoints
  - name: Part Numbers
    description: Part Number Endpoints
  - name: Processes
    description: Process Endpoints
  - name: Properties
    description: Property Endpoints
  - name: Storage
    description: Storage Endpoints
  - name: Users
    description: User Endpoints
  - name: Work Orders
    description: Work Order Endpoints
paths:
  /files:
    get:
      tags:
        - Storage
      summary: List Files
      description: Get files
      operationId: get-files
      parameters:
        - schema:
            type: string
          in: query
          name: component_instance_id
          description: Get only files associated with given component instance id
        - schema:
            type: boolean
          in: query
          name: image_only
          description: Only return associated images
        - schema:
            type: boolean
          in: query
          name: files_only
          description: Only return associated files
        - schema:
            type: string
          in: query
          name: name
          description: Only return files matching a given name (must be an exact match)
        - schema:
            type: string
          in: query
          name: process_entry_id
          description: Only return files created at a given process entry
        - schema:
            type: string
          in: query
          name: process_id
          description: Only return files created at a given process
        - schema:
            type: string
          in: query
          name: dataset_id
          description: Only return files associated with a given dataset
      responses:
        '200':
          description: OK
          content:
            application/octet-stream:
              schema:
                type: object
                properties: {}
components:
  securitySchemes:
    serial-default-security:
      type: http
      scheme: bearer
      description: '**API Key** or **Token** formatted as `Bearer <YOUR_KEY_OR_TOKEN>`'

````