---
title: "Get object store bucket details"
method: GET
path: "/api/v1/orgs/{orgId}/buckets/{name}"
tags: ["storage"]
---

# Get object store bucket details

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

Retrieves the details of the object store bucket given its name

## Path parameters

- `orgId` integer, required
- `name` string, required

## Query parameters

- `cloudType` 'amazon' | 'google' | 'azure', required
- `resourceGroup` string
- `storageAccount` string
- `location` string

## Headers

- `secretId` string
- `secretName` string

## Response `200`

Object store bucket details

- 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

## Changes

- **2026-07-17** `a2e35c430378` — 1 breaking
  - the `secret` response's property type changed from no type to `object` for status `200`
- **2021-01-28** `0caa9634f495` — 1 breaking
  - removed the enum value `alibaba` from the `query` request parameter `cloudType`
- **2021-01-22** `1d054e88f757` — 1 breaking, 1 warning
  - removed the enum value `oracle` from the `query` request parameter `cloudType`
  - removed the optional property `oracle` from the response with the `200` status
- **2020-04-24** `5186ea64aa56` — 1 breaking, 3 info
  - the `secret` response's property type changed from `object` to no type for status `200`
  - added the new enum value `alibaba` to the `query` request parameter `cloudType`
  - added the new enum value `oracle` to the `query` request parameter `cloudType`
  - added the optional property `oracle` to the response with the `200` status

[Change history](https://skmtc.dev/banzaicloud/apis/pipeline-api/changes/api/v1/orgs/:orgId/buckets/:name/get.md)

---

[API](https://skmtc.dev/banzaicloud/apis/pipeline-api.md) · [All operations](https://skmtc.dev/banzaicloud/apis/pipeline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/banzaicloud/apis/pipeline-api/revisions/a2e35c430378?raw)