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

# List Files

> Listing your files



## OpenAPI

````yaml /api-1(21).json get /api-files/list
openapi: 3.0.3
info:
  title: Radin AI API docs
  description: '### Welcome to Radin AI API docs'
  version: '1.0'
  contact:
    name: Support
    url: https://radinai.com/support
servers:
  - url: https://api2.radinai.com
    description: API base URL
security:
  - ApiKeyAuth: []
externalDocs:
  url: https://radinai.com/api-dashboard
  description: API Dashboard
paths:
  /api-files/list:
    get:
      tags:
        - Files
      summary: List Files
      description: Listing your files
      operationId: getApi-filesList
      parameters:
        - name: variant
          in: query
          required: false
          schema:
            default: all
            description: >-
              An array of file types you want to list, if not selected, all
              types will be listed.
            type: string
            enum:
              - all
              - uploaded
              - generated
        - name: mimeTypes
          in: query
          required: false
          schema:
            description: >-
              An array of file MIME types you want to list, if not selected, all
              types will be listed.
            type: array
            items:
              default: image/png
              type: string
              enum:
                - image/png
                - image/jpeg
                - image/webp
                - video/quicktime
                - video/mp4
                - audio/mp3
                - audio/wav
                - audio/x-wav
                - audio/mpeg
        - name: offset
          in: query
          required: true
          schema:
            minimum: 0
            anyOf:
              - format: numeric
                default: 0
                type: string
              - minimum: 0
                type: number
        - name: limit
          in: query
          required: true
          schema:
            minimum: 3
            maximum: 24
            anyOf:
              - format: numeric
                default: 0
                type: string
              - minimum: 3
                maximum: 24
                type: number
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  hasNextPage:
                    type: boolean
                  files:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: >-
                            The file name, you can pass this name to generation
                            endpoints
                        id:
                          type: string
                          description: >-
                            The file ID, it is used for identification purposes
                            only, it cannot be used as a file name in generation
                            endpoints
                        links:
                          type: object
                          properties:
                            private:
                              type: string
                              description: Download link that requires an API key
                            publicTemporary:
                              type: string
                              description: >-
                                Temporary download link (valid for 10-30
                                minutes), does not require an API key
                          required:
                            - private
                            - publicTemporary
                          additionalProperties: false
                        mimeType:
                          type: string
                          enum:
                            - image/png
                            - image/jpeg
                            - image/webp
                            - video/quicktime
                            - video/mp4
                            - audio/mp3
                            - audio/wav
                            - audio/x-wav
                            - audio/mpeg
                        size:
                          type: number
                        type:
                          type: string
                          enum:
                            - ai_generated
                            - user_uploaded
                        createdAt:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                          description: timestamp in milliseconds since epoch
                      required:
                        - name
                        - id
                        - links
                        - mimeType
                        - size
                        - type
                        - createdAt
                      additionalProperties: false
                required:
                  - hasNextPage
                  - files
                additionalProperties: false
        '400':
          description: Response for status 400
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '403':
          description: Response for status 403
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '500':
          description: Response for status 500
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key, obtained from https://radinai.com/manage-api-keys

````