## Get Bucket Details

**get** `/v1/storage/buckets/{bucket_id}`

Get details about a Bucket

### Path Parameters

- `bucket_id: string`

### Returns

- `Bucket object { id, created_at, endpoint, 10 more }`

  Bucket details.

  - `id: string`

    Unique identifier for the Bucket.

  - `created_at: string`

    When the Bucket was created.

  - `endpoint: string`

    S3 endpoint of the Bucket's region. Point S3 clients at it, with an Object
    Storage Key of the same project and region.

  - `name: string`

    Name of the Bucket, used to address it over S3.

  - `object_count: number`

    Number of objects in the Bucket. Updated periodically, so it can lag behind
    recent writes.

  - `project_id: string`

    Project ID the Bucket belongs to.

  - `region: RegionName`

    Region the resource is in.

    - `"us-sva-2"`

    - `"us-wdc-1"`

  - `signing_region: string`

    Region S3 clients must sign their requests for (the SigV4 region). Configure
    it as the region of any S3 client or SDK used with the Bucket.

  - `size_bytes: number`

    Total size of the objects in the Bucket, in bytes. Updated periodically,
    so it can lag behind recent writes.

  - `status: ResourceStatus`

    Status of the resource.

    - `"pending"`

    - `"creating"`

    - `"updating"`

    - `"ready"`

    - `"deleting"`

    - `"deleted"`

    - `"error"`

    - `"suspended"`

  - `tags: array of string`

    Tags attached to the Bucket.

  - `updated_at: string`

    When the Bucket was updated.

  - `url: string`

    Path-style URL of the Bucket.

### Example

```http
curl https://api.nirvanalabs.io/v1/storage/buckets/$BUCKET_ID \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
```

#### Response

```json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "endpoint": "https://s3.sva2.nirvanacloud.io",
  "name": "my-bucket",
  "object_count": 1024,
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "region": "us-sva-2",
  "signing_region": "us-east-1",
  "size_bytes": 1073741824,
  "status": "ready",
  "tags": [
    "production",
    "ethereum"
  ],
  "updated_at": "2025-01-01T00:00:00Z",
  "url": "https://s3.sva2.nirvanacloud.io/my-bucket"
}
```
