> ## Documentation Index > Fetch the complete documentation index at: https://gcore.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List S3-compatible storages > Returns a paginated list of S3-compatible storage instances for the authenticated client. ## OpenAPI ````yaml /api-reference/services_documented/object_storage_api.yaml get /storage/v4/object_storages openapi: 3.1.0 info: title: Gcore OpenAPI – Object Storage API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: '2026-05-11T15:10:30.328297+00:00' servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Notifications x-displayName: Notifications - name: SSHKeys x-displayName: SSHKeys - name: Storage Locations x-displayName: Storage Locations - name: Storage x-displayName: Storage - name: Storage Statistics x-displayName: Storage Statistics - name: S3-Compatible Storage x-displayName: S3-Compatible Storage - name: SFTP Storage x-displayName: SFTP Storage paths: /storage/v4/object_storages: get: tags: - S3-Compatible Storage summary: List S3-compatible storages description: >- Returns a paginated list of S3-compatible storage instances for the authenticated client. operationId: listS3StoragesV4 parameters: - name: id in: query description: Filter by storage ID schema: type: string - name: name in: query description: Filter by storage name schema: type: string - name: location_name in: query description: Filter by storage location/region schema: type: string - name: offset in: query description: Number of records to skip schema: minimum: 0 type: integer format: uint64 - name: limit in: query description: Max number of records in response schema: maximum: 1000 minimum: 1 type: integer format: uint64 default: 10 - name: order_by in: query schema: type: string default: created_at.desc - name: provisioning_status in: query description: Filter by provisioning status schema: type: string enum: - active - creating - updating - deleting - deleted - name: show_deleted in: query description: Include deleted storages schema: type: boolean responses: '200': description: S3StorageListEndpointResV4 content: application/json: schema: $ref: '#/components/schemas/S3StorageListEndpointResV4' '400': description: ErrResponse content: application/json: schema: $ref: '#/components/schemas/ErrResponse' '401': description: ErrResponse content: application/json: schema: $ref: '#/components/schemas/ErrResponse' '403': description: ErrResponse content: application/json: schema: $ref: '#/components/schemas/ErrResponse' x-codeSamples: - lang: Python source: |- import os from gcore import Gcore client = Gcore( api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted ) page = client.storage.object_storages.list() page = page.results[0] print(page.id) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/G-Core/gcore-go\"\n\t\"github.com/G-Core/gcore-go/option\"\n\t\"github.com/G-Core/gcore-go/storage\"\n)\n\nfunc main() {\n\tclient := gcore.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tpage, err := client.Storage.ObjectStorages.List(context.TODO(), storage.ObjectStorageListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n" components: schemas: S3StorageListEndpointResV4: title: >- S3StorageListEndpointResV4 Paginated list of S3-compatible storages owned by the authenticated client. required: - count - results type: object properties: count: type: integer description: Total number of S3 storages matching the filter format: int64 example: 1 results: type: array description: The list of S3 storages items: $ref: '#/components/schemas/S3StorageListItemV4' ErrResponse: type: object properties: error: type: string description: ErrResponse is an error response S3StorageListItemV4: title: >- S3StorageListItemV4 S3-compatible storage summary. Use the id to fetch full details or the address to connect. required: - address - created_at - full_name - id - location_name - name - provisioning_status type: object properties: address: type: string description: Full hostname/address for accessing the storage endpoint example: luxembourg-2.storage.example.com created_at: type: string description: ISO 8601 timestamp when the storage was created format: date-time example: '2025-08-05T09:17:02Z' full_name: type: string description: >- Read-only internal full name of the storage, composed as "{`client_id`}-{name}". Used internally by the backend. Clients should continue to identify the storage by `name`. example: 696-my-storage-prod id: type: integer description: Unique identifier for the storage instance format: int64 example: 1 location_name: type: string description: Geographic location code where the storage is provisioned example: luxembourg-2 name: type: string description: >- User-defined name for the storage instance, as supplied at creation time. example: my-storage-prod provisioning_status: type: string description: >- Lifecycle status of the storage. Use this to check readiness before operations. example: active enum: - creating - active - updating - deleting - deleted securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234$abcdef` type: apiKey in: header name: Authorization ````