---
title: "Lists all S3 buckets in the project and returns their details."
method: GET
path: "/projects/{project_id}/storage/s3/buckets"
tags: ["S3Buckets"]
---

# Lists all S3 buckets in the project and returns their details.

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

## Path parameters

- `project_id` string, required

## Query parameters

- `next_page_token` string
- `prev_page_token` string
- `page_size` integer

## Response `200`

- ListS3BucketsResponse
  - `items` S3Bucket[], required — List of buckets.
    - `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
  - `next_page_token` string — Next page token.
  - `prev_page_token` string — Previous page token.

## Other responses

- `401` — Error Authentication Failed
- `403` — Error Permissions
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)