--- id: storage-getbucket title: "getBucket()" slug: storage-getbucket custom_edit_url: https://github.com/supabase/supabase/edit/master/web/spec/supabase.yml --- import Tabs from '@theme/Tabs'; import TabsPanel from '@theme/TabsPanel'; Retrieves the details of an existing Storage bucket. ```js const { data, error } = await supabase .storage .getBucket('avatars') ``` ## Parameters ## Notes - Policy permissions required: - `buckets` permissions: `select` - `objects` permissions: none ## Examples ### Get bucket ```js const { data, error } = await supabase .storage .getBucket('avatars') ```