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

# List Bucket Contents



## OpenAPI

````yaml GET /api/v1/files/list
openapi: 3.0.1
info:
  title: File Storage API
  description: >-
    API for managing file storage operations including uploads, downloads, and
    bucket management
  version: 1.0.0
servers:
  - url: https://api.apexxcloud.com
security:
  - apiAuth: []
    signatureAuth: []
    timestampAuth: []
paths:
  /api/v1/files/list:
    get:
      summary: List Bucket Contents
      parameters:
        - name: bucket_name
          in: query
          required: true
          schema:
            type: string
        - name: region
          in: query
          required: true
          schema:
            type: string
        - name: prefix
          in: query
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: integer
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: List of bucket contents
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBucketResponse'
components:
  schemas:
    ListBucketResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            contents:
              type: object
              properties:
                name:
                  type: string
                type:
                  type: string
                path:
                  type: string
                children:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      type:
                        type: string
                      path:
                        type: string
                      size:
                        type: integer
                      content_type:
                        type: string
                      last_modified:
                        type: string
                      visibility:
                        type: string
            pagination:
              type: object
              properties:
                current_page:
                  type: integer
                total_pages:
                  type: integer
                total_items:
                  type: integer
                items_per_page:
                  type: integer
  securitySchemes:
    apiAuth:
      type: apiKey
      in: header
      name: X-Access-Key
      description: Your API Access Key
    signatureAuth:
      type: apiKey
      in: header
      name: X-Signature
      description: HMAC SHA-256 signature of the request
    timestampAuth:
      type: apiKey
      in: header
      name: X-Timestamp
      description: ISO 8601 timestamp of the request

````