# List buckets (/docs/rest-api/endpoints/buckets/get-buckets)

> For the complete Prisma documentation index, see [llms.txt](https://www.prisma.io/docs/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Returns all object-store buckets the token has access to. Optionally filter by project ID.

Location: REST API > Endpoints > Buckets > List buckets



## Related pages

- [`Create bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/post-buckets): Creates a new object-store bucket in the specified project.
- [`Create bucket key`](https://www.prisma.io/docs/rest-api/endpoints/buckets/post-buckets-by-bucket-id-keys): Creates a new access key for the given bucket. The `secretAccessKey` field is returned exactly once in this response and is never stored — copy it immediately.
- [`Delete bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/delete-buckets-by-bucket-id): Permanently deletes the bucket with the given ID, all objects stored in it, and all its access keys. This action cannot be undone.
- [`Delete bucket key`](https://www.prisma.io/docs/rest-api/endpoints/buckets/delete-buckets-by-bucket-id-keys-by-key-id): Revokes and deletes the bucket key with the given ID.
- [`Get bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/get-buckets-by-bucket-id): Returns the bucket with the given ID.