> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.sevalla.com/llms.txt > Use this file to discover all available pages before exploring further. # List objects > List objects in the bucket using cursor-based pagination. Use the `prefix` and `delimiter` parameters to browse the bucket like a file system. ## OpenAPI ````yaml https://api.sevalla.com/v3/openapi.json get /object-storage/{id}/objects openapi: 3.1.0 info: title: Sevalla API docs version: 1.0.0 servers: - url: https://api.sevalla.com/v3 security: - bearerAuth: [] paths: /object-storage/{id}/objects: get: tags: - Object storages summary: List objects description: >- List objects in the bucket using cursor-based pagination. Use the `prefix` and `delimiter` parameters to browse the bucket like a file system. operationId: listObjectStorageObjectsV3 parameters: - schema: example: images/ type: string in: query name: prefix required: false description: Filter objects by key prefix - schema: example: / type: string in: query name: delimiter required: false description: Character used to group keys into common prefixes (typically "/") - schema: type: string in: query name: cursor required: false description: Continuation token from a previous response for pagination - schema: default: 25 example: 25 type: integer minimum: 1 maximum: 200 in: query name: limit required: false description: Maximum number of objects to return per page. Maximum 200. - schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ example: fb5e5168-4281-4bec-94c5-0d1584e9e657 in: path name: id required: true description: Object storage bucket identifier responses: '200': description: Default Response content: application/json: schema: type: object properties: data: type: array items: type: object properties: key: type: string description: >- Full object key (path) within the bucket. Folder prefixes end with "/". example: images/photo.jpg type: type: string enum: - folder - file - image - video - audio - document description: >- Object type inferred from the file extension. `folder` - a prefix acting as a folder. `file` - generic file. `image` - image file (jpg, png, etc). `video` - video file (mp4, mov, etc). `audio` - audio file (mp3, wav, etc). `document` - document file (pdf, doc, etc). example: file content_type: anyOf: - type: string - type: 'null' description: MIME content type of the object example: image/jpeg size: anyOf: - type: number minimum: 0 - type: 'null' description: Object size in bytes example: 1024 updated_at: anyOf: - type: string - type: 'null' description: ISO 8601 timestamp of the last modification example: '2024-01-01T00:00:00.000Z' e_tag: anyOf: - type: string - type: 'null' description: Entity tag for the object, used for cache validation example: '"abc123"' required: - key - type - content_type - size - updated_at - e_tag additionalProperties: false description: List of objects cursor: anyOf: - type: string - type: 'null' description: >- Continuation token for the next page. Null if there are no more results. required: - data - cursor additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Unauthorized status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 401 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Forbidden status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 403 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Not found status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 404 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Internal Server Error status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 500 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication. Pass your API key as a Bearer token in the Authorization header. ````