# Get Files

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/files?sort=size:
    get:
      summary: Get Files
      deprecated: false
      description: Get account files
      tags:
        - Snapbyte APIs/Files
      parameters:
        - name: offset
          in: query
          description: Query offset
          required: false
          example: 0
          schema:
            type: integer
        - name: limit
          in: query
          description: 'Number of file per page, max: 100'
          required: false
          example: 100
          schema:
            type: integer
        - name: search
          in: query
          description: Search file name by this string
          required: false
          example: abc
          schema:
            type: string
        - name: sort
          in: query
          description: Sort the result by this field
          required: false
          example: size
          schema:
            type: string
            enum:
              - name
              - size
              - status
            x-apidog-enum:
              - value: name
                name: ''
                description: ''
              - value: size
                name: ''
                description: ''
              - value: status
                name: ''
                description: ''
        - name: order
          in: query
          description: Sort ascending (asc) or descending (desc)
          required: false
          example: asc
          schema:
            type: string
            enum:
              - asc
              - desc
            x-apidog-enum:
              - value: asc
                name: ''
                description: ''
              - value: desc
                name: ''
                description: ''
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: Number of file in the result
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: File ID generated by Snapbyte
                      file_name:
                        type: string
                        description: File name
                      file_size:
                        type: integer
                        description: File size
                      file_md5:
                        type: string
                        description: File MD5
                      file_id:
                        type: string
                        description: File ID provided by client via API
                      file_sign_url:
                        type: string
                        description: Origin signed url provided by the client
                      file_sign_url_expire:
                        type: string
                        description: Orign signed url expire time
                      status:
                        type: integer
                        enum:
                          - 1
                          - 2
                          - 3
                          - 4
                        x-apidog-enum:
                          - value: 1
                            name: New
                            description: File just created and waiting to be process
                          - value: 2
                            name: Done
                            description: File is processed and cached
                          - value: 3
                            name: Error
                            description: Failed to processed
                          - value: 4
                            name: Processing
                            description: File is caching
                        description: Status of file
                      ctime:
                        type: string
                        description: Creation time
                      utime:
                        type: string
                        description: Update time
                      mime_type:
                        type: string
                        description: File mine type
                    x-apidog-orders:
                      - id
                      - file_name
                      - file_size
                      - file_id
                      - file_md5
                      - file_sign_url
                      - file_sign_url_expire
                      - status
                      - mime_type
                      - ctime
                      - utime
                    required:
                      - id
                      - file_sign_url_expire
                      - file_sign_url
                      - file_id
                      - file_size
                      - file_name
                      - status
                      - utime
                      - ctime
                      - mime_type
                x-apidog-orders:
                  - total
                  - data
                required:
                  - total
                  - data
              example:
                total: 2
                data:
                  - id: fabd74d3-8c81-4318-b1b0-05e386359159
                    file_name: 300MB-Corrupt-Testfile.Org.zip
                    file_size: '314572800'
                    file_id: 2220f3ce8a1a9a73bc9910d4180864e0233716
                    file_md5: ''
                    file_sign_url: >-
                      https://files.testfile.org/ZIPC/300MB-Corrupt-Testfile.Org.zip
                    file_sign_url_expire: '2028-08-30T10:43:42.000Z'
                    status: 2
                    mime_type: application/x-zip-compressed
                    ctime: '2025-07-07T08:59:38.578Z'
                    utime: '2025-07-07T09:00:54.593Z'
                  - id: c19253ac-52a8-4353-a3c9-1c7f23232027
                    file_name: Screen Recording 2025-06-30 at 09.15.25.mov
                    file_size: '50902249'
                    file_id: 1ASDW4XQM0kzU-gVz85ll70mueDOY6PSw
                    file_md5: e18053b11ecdfe8329caba3d601f5425
                    file_sign_url: >-
                      https://www.googleapis.com/drive/v3/files/1ASDW4XQM0kzU-gVz85ll70mueDOY6PSw?alt=media
                    file_sign_url_expire: '2999-12-31T23:59:59.000Z'
                    status: 2
                    mime_type: video/quicktime
                    ctime: '2025-07-07T08:47:10.670Z'
                    utime: '2025-07-07T08:52:18.293Z'
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Snapbyte APIs/Files
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/991601/apis/api-18887083-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.snapbyte.io
    description: Prod Env
security: []

```