# List buckets (/docs/management-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: Management API > Endpoints > Buckets > List buckets

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

## API reference

### List buckets

`GET /v1/buckets`

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

#### Parameters

- `cursor` (query, string | null, optional): Cursor for pagination
- `limit` (query, integer, optional): Page size, 1-100
- `projectId` (query, string, optional): Filter buckets by project ID
- `branchId` (query, optional)
- `branchGitName` (query, string, optional)

#### Responses

- `200`: Returns the list of buckets.
- `401`: Missing or invalid authorization token.

## Related pages

- [`Create bucket`](https://www.prisma.io/docs/management-api/endpoints/buckets/post-buckets): Creates a new object-store bucket in the specified project.
- [`Create bucket key`](https://www.prisma.io/docs/management-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/management-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/management-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/management-api/endpoints/buckets/get-buckets-by-bucket-id): Returns the bucket with the given ID.