# List buckets

```http
GET /v1/tenants/{tenantId}/buckets
```

Base URL: `https://api-portal.aur.lu/api`

Operation ID: `ListBuckets`

Authentication: ApiKeyAuth (API key in header `X-Api-Key`)

Required permission: `read:s3:buckets`

Returns the list of active buckets for the given tenant

## Parameters

### Path parameters

- `tenantId` (string, required) — Tenant ID

### Query parameters

- `page` (integer, default: `1`) — Page number
- `pageSize` (integer, default: `20`) — Page size

## Responses

### 200 — Bucket list

Content type: `application/json`

- `items` (array of object)
  - items (object)
    - `createdAt` (string)
    - `flags` (array of string, items one of: `unencrypted`, `encrypted`, `versioned`)
    - `name` (string)
    - `shared` (boolean)
- `page` (integer)
- `pageSize` (integer)
- `totalCount` (integer)