---
title: "List object storage buckets"
method: GET
path: "/api/v1/orgs/{orgId}/buckets"
tags: ["storage"]
---

# List object storage buckets

`GET /api/v1/orgs/{orgId}/buckets`

List object store buckets accessible by the credentials referenced by the given secret. If no credentials provided all managed buckets are returned for all cloud types.

## Path parameters

- `orgId` integer, required

## Query parameters

- `cloudType` 'amazon' | 'google' | 'azure'
- `include` 'secret'

## Headers

- `secretId` string

## Response `200`

Storage buckets listed

- BucketInfo[]
  - `name` string, required — the name of the object storage / bucket
  - `managed` boolean, required — true if the bucket has been created via pipeline
  - `cloud` string, required — cloud provider of the bucket
  - `location` string, required — location of the bucket
  - `notes` string — notes for the bucket
  - `secret` BucketInfoSecret
    - `id` string, required
    - `name` string
    - `accessId` string — the secret identifier of the azure access information
    - `accessName` string — the secret name of the azure access information
  - `aks` AzureBlobStorageProps
    - `resourceGroup` string, required
    - `storageAccount` string, required
  - `status` 'CREATING' | 'AVAILABLE' | 'ERROR_CREATE' | 'DELETING' | 'ERROR_DELETE', required — the status of the bucket
  - `statusMessage` string — the reason for the error status

## Other responses

- `default` — Internal server error

---

[API](https://skmtc.net/banzaicloud/apis/pipeline-api.md) · [All operations](https://skmtc.net/banzaicloud/apis/pipeline-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banzaicloud/pipeline-api/versions/a2e35c430378/schema)