---
title: "Returns details for a single S3 bucket in the project."
method: GET
path: "/projects/{project_id}/storage/s3/buckets/{bucket_name}"
tags: ["S3Buckets"]
---

# Returns details for a single S3 bucket in the project.

`GET /projects/{project_id}/storage/s3/buckets/{bucket_name}`

## Request

- Base URL: `https://api.cloud.crusoe.ai/v1`
- URL: `https://api.cloud.crusoe.ai/v1/projects/{project_id}/storage/s3/buckets/{bucket_name}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/docs/projects/:project_id/storage/s3/buckets/:bucket_name/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `project_id` string, required
- `bucket_name` string, required

## Response `200`

- S3Bucket: This is the REST-friendly model for the `BucketInfo` proto.
  - `archived_at` string: Archive timestamp of the bucket, in RFC3339 format.
  - `bucket_size` number, float: Size of the bucket, in GiB.
  - `created_at` string, required: Creation timestamp of the bucket, in RFC3339 format.
  - `location` string, required: Location where the bucket is hosted.
  - `name` string, required: Name of the bucket.
  - `object_lock_enabled` boolean, required: Whether object lock is enabled.
  - `project_id` string, required: ID of the project that owns the bucket.
  - `retention_mode` string: enum: governance,compliance
  - `retention_period` integer: Length of the object lock retention period, in the unit given by retention_period_unit.
  - `retention_period_unit` string: enum: days,years
  - `s3_url` string: Endpoint URL for accessing the bucket.
  - `tags` object: Tags applied to the bucket as key-value pairs.
  - `updated_at` string, required: Last update timestamp of the bucket, in RFC3339 format.
  - `user_id` string, required: ID of the S3 user that owns the bucket.
  - `versioning_state` string, required: enum: disabled,enabled,suspended

## Other responses

- `401`: Error Authentication Failed
- `403`: Error Permissions
- `404`: Error Not Found
- `500`: Error Internal Server

---

[API](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway.md) - [All operations](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/revisions/a3fd2dedc72b?raw)