---
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

---

[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)