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

# List Objects

> Return list of objects ( max:50, min:1 )



## OpenAPI

````yaml /spec/object-storage.yaml get /api/v1/buckets/{bucket}/objects/{prefix}
openapi: 3.0.1
info:
  title: Object Storage API Documentaion
  description: |-
    A scalable, reliable, and cost effective Object Storage solution to
    support your application from liara-cloud

    Parameters:
    - `teamID`: To access services in a team
  contact:
    name: liara
    url: https://liara.ir
    email: support@liara.ir
  version: 1.0.0
servers:
  - url: https://storage-service.iran.liara.ir
security:
  - jwt: []
tags:
  - name: Bucket
    description: Operations about bucket
  - name: Key
    description: Operations about key
  - name: Folder
    description: Operations about folder
  - name: Object
    description: Operations about object
externalDocs:
  description: Find out more about Liara Object Storage
  url: https://docs.liara.ir/buckets/about/
paths:
  /api/v1/buckets/{bucket}/objects/{prefix}:
    get:
      tags:
        - Object
      summary: List Objects
      description: Return list of objects ( max:50, min:1 )
      operationId: getListObjects
      parameters:
        - name: bucket
          in: path
          required: true
          schema:
            type: string
        - name: prefix
          in: path
          required: true
          schema:
            type: string
        - name: number
          in: query
          description: 'specify number of object ( max: 50, min: 1 )'
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Objects'
        '400':
          description: Bad Request
          content: {}
        '401':
          description: Missing authentication
          content: {}
        '404':
          description: Not Found
          content: {}
        '409':
          description: Conflict
          content: {}
        '500':
          description: server does not response
          content: {}
components:
  schemas:
    Objects:
      type: object
      properties:
        status:
          type: string
        data:
          type: object
          properties:
            objects:
              type: object
              properties:
                IsTruncated:
                  type: boolean
                Contents:
                  type: array
                  items:
                    type: object
                    properties:
                      Key:
                        type: string
                      LastModified:
                        type: string
                      ETag:
                        type: string
                      ChecksumAlgorithm:
                        type: array
                        items:
                          type: object
                          properties: {}
                      Size:
                        type: number
                      StorageClass:
                        type: string
                Name:
                  type: string
                Prefix:
                  type: string
                Delimiter:
                  type: string
                MaxKeys:
                  type: number
                CommonPrefixes:
                  type: array
                  items:
                    type: object
                    properties:
                      Prefix:
                        type: string
                KeyCount:
                  type: number
  securitySchemes:
    jwt:
      type: apiKey
      description: 'Enter the token with the `Bearer: ` prefix, e.g. "Bearer abcde12345".  #'
      name: Authorization
      in: header

````