---
title: "Get all buckets"
method: GET
path: "/kos/v1/buckets"
tags: ["Buckets"]
---

# Get all buckets

`GET /kos/v1/buckets`

## Query parameters

- `page` integer
- `page_size` integer
- `name_filter` string
- `refresh` boolean

## Response `200`

Bucket successfully retrieved

- BucketsResponse
  - `totalItems` integer — Total number of items
  - `totalPages` integer — Total number of pages
  - `currentPage` integer — Current page number
  - `nextPage` integer — Next page number, if available
  - `items` BucketResponse[]
    - `name` string, nullable
    - `krnid` string, nullable
    - `owner` string
    - `account_id` string
    - `createdAt` string, date-time, nullable
    - `usedCapacity` number, double, nullable
    - `allocatedCapacity` integer, nullable
    - `region` string, nullable
    - `url` string, nullable
    - `status` string, nullable
    - `path` string, nullable
    - `protocol` string, nullable
    - `tags` object, nullable
    - `versioning` boolean, nullable
    - `anonymous_access` boolean, nullable
    - `tier` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/olakrutrim/apis/object-storage-bucket-api.md) · [All operations](https://skmtc.net/olakrutrim/apis/object-storage-bucket-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olakrutrim/object-storage-bucket-api/revisions/01a982e59414/schema)