--- title: Get Bucket --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [R2](https://developers.cloudflare.com/api/go/resources/r2) [Buckets](https://developers.cloudflare.com/api/go/resources/r2/subresources/buckets) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Bucket client.R2.Buckets.Get(ctx, bucketName, params) (\*[Bucket](), error) GET/accounts/{account\_id}/r2/buckets/{bucket\_name} Gets properties of an existing R2 bucket. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### ParametersExpand Collapse bucketName string Name of the bucket. maxLength64 minLength3 [Link to this property](<#(resource)%20r2.buckets%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20bucket_name%20%3E%20(schema)>)
params BucketGetParams AccountID param.Field\[string] Path param: Cloudflare account ID that owns the R2 resource. maxLength32 Link to this property
CfR2Jurisdiction param.Field\[BucketGetParamsCfR2Jurisdiction]Optional Header param: Jurisdiction where objects in this bucket are guaranteed to be stored. const BucketGetParamsCfR2JurisdictionDefault BucketGetParamsCfR2Jurisdiction = "default" Link to this property const BucketGetParamsCfR2JurisdictionEu BucketGetParamsCfR2Jurisdiction = "eu" Link to this property const BucketGetParamsCfR2JurisdictionUs BucketGetParamsCfR2Jurisdiction = "us" Link to this property const BucketGetParamsCfR2JurisdictionFedramp BucketGetParamsCfR2Jurisdiction = "fedramp" Link to this property const BucketGetParamsCfR2JurisdictionFedrampHigh BucketGetParamsCfR2Jurisdiction = "fedramp-high" Link to this property
Link to this property
[Link to this property](<#(resource)%20r2.buckets%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Bucket struct{…} A single R2 bucket. CreationDate stringOptional Creation timestamp. Link to this property
Jurisdiction BucketJurisdictionOptional Jurisdiction where objects in this bucket are guaranteed to be stored. One of the following: const BucketJurisdictionDefault BucketJurisdiction = "default" Link to this property const BucketJurisdictionEu BucketJurisdiction = "eu" Link to this property const BucketJurisdictionUs BucketJurisdiction = "us" Link to this property const BucketJurisdictionFedramp BucketJurisdiction = "fedramp" Link to this property const BucketJurisdictionFedrampHigh BucketJurisdiction = "fedramp-high" Link to this property
Link to this property
Location BucketLocationOptional Location of the bucket. One of the following: const BucketLocationApac BucketLocation = "apac" Link to this property const BucketLocationEeur BucketLocation = "eeur" Link to this property const BucketLocationEnam BucketLocation = "enam" Link to this property const BucketLocationWeur BucketLocation = "weur" Link to this property const BucketLocationWnam BucketLocation = "wnam" Link to this property const BucketLocationOc BucketLocation = "oc" Link to this property
Link to this property Name stringOptional Name of the bucket. maxLength64 minLength3 Link to this property
StorageClass BucketStorageClassOptional Storage class for newly uploaded objects, unless specified otherwise. One of the following: const BucketStorageClassStandard BucketStorageClass = "Standard" Link to this property const BucketStorageClassInfrequentAccess BucketStorageClass = "InfrequentAccess" Link to this property
Link to this property
[Link to this property](<#(resource)%20r2.buckets%20%3E%20(model)%20bucket%20%3E%20(schema)>) ### Get Bucket Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/r2" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) bucket, err := client.R2.Buckets.Get( context.TODO(), "example-bucket", r2.BucketGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", bucket.CreationDate) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": { "creation_date": "creation_date", "jurisdiction": "default", "location": "apac", "name": "example-bucket", "storage_class": "Standard" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": { "creation_date": "creation_date", "jurisdiction": "default", "location": "apac", "name": "example-bucket", "storage_class": "Standard" }, "success": true } ```