---
title: "List SOS Buckets Usage"
method: GET
path: "/sos-buckets-usage"
tags: ["sos"]
---

# List SOS Buckets Usage

`GET /sos-buckets-usage`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/sos-buckets-usage`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/sos-buckets-usage/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

200

- object
  - `sos-buckets-usage` SosBucketUsage[]
    - `name` string: SOS Bucket name
    - `created-at` string, date-time: SOS Bucket creation date
    - `zone-name` 'ch-dk-2' | 'de-muc-1' | 'ch-gva-2' | 'at-vie-1' | 'de-fra-1' | 'bg-sof-1' | 'at-vie-2' | 'hr-zag-1'
    - `size` integer: SOS Bucket size in B

## Changes

- **2025-08-10** `814bf1ccd925`: 1 warning
  - added the new `hr-zag-1` enum value to the `sos-buckets-usage/items/zone-name` response property for the response status `200`
- **2023-06-06** `cf7b08181585`: 1 warning
  - added the new `at-vie-2` enum value to the `sos-buckets-usage/items/zone-name` response property for the response status `200`
- **2023-02-03** `6e9809fd1444`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/sos-buckets-usage/get.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)