> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# S3 List Buckets

Returns a list of all buckets owned by the authenticated sender of the request.

<Note>
  External Documentation

  To learn more, visit the [AWS documentation](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter  | Description                   |
  | ---------- | ----------------------------- |
  | AWS Region | Enter the desired AWS Region. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                        | Description                                                                                                                                                                                                                                                                           |
  | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Disable XML To JSON Auto Convert | When checked, XML responses are not automatically converted into JSON format.                                                                                                                                                                                                         |
  | Query                            | A JMESPath query to use in filtering the response data.<br /><br />Querying uses [JMESPath syntax](https://jmespath.org/) to create expressions for filtering your output.<br />To learn JMESPath syntax, see [Tutorial](https://jmespath.org/tutorial.html) on the JMESPath website. |
</div>

## Example Output

```json theme={"dark"}
{
	"Buckets": {
		"Bucket": [
			{
				"CreationDate": "2019-12-11T23:32:47+00:00",
				"Name": "amzn-s3-demo-bucket"
			},
			{
				"CreationDate": "2019-11-10T23:32:13+00:00",
				"Name": "amzn-s3-demo-bucket1"
			}
		]
	},
	"Owner": {
		"DisplayName": "Account+Name",
		"ID": "AIDACKCEVSQ6C2EXAMPLE"
	}
}
```

## Workflow Library Example

[S3 List Buckets with Aws and Send Results Via Email](https://library.blinkops.com/workflows/s3-list-buckets-with-aws-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/s3-list-buckets-with-aws-and-send-results-via-email/canvas" />
</div>