---
title: "list metadata for all backends"
method: GET
path: "/v1/backends/metadata"
tags: ["Metadata"]
---

# list metadata for all backends

`GET /v1/backends/metadata`

## Query parameters

- `backendName` string
- `region` string
- `sizeOfObject` integer
- `bucketName` string
- `sizeOfBucket` integer
- `bucketSizeOperator` string
- `objectSizeOperator` string
- `objectName` string
- `limit` integer
- `offset` integer

## Response `200`

successful operation.

- object
  - `buckets` Metadata[]
    - `id` string — The backend ID, generated by server
    - `backendName` string — The tenant UUID in a multi-tenancy environment.
    - `type` 'aws-s3' | 'azure-blob' | 'gcp-s3' | 'fusionstorage-object' | 'ibm-cos' | 'yig' | 'aws-file' | 'azure-file' — The backend type.
    - `region` string
    - `numberOfBuckets` integer — The total no of buckets.
    - `numberOfFilteredBuckets` integer — The total no of filtered buckets.
  - `next` integer

## Other responses

- `401` — Unauthorized. Token not found in header
- `415` — Unsupported Media Type

## Changes

- **2025-01-08** `6517d105571e` — 2 info
  - removed the `ceph-s3` enum value from the `buckets/items/type` response property for the response status `200`
  - removed the `hw-obs` enum value from the `buckets/items/type` response property for the response status `200`
- **2023-09-17** `d4f502a59e17` — 2 warning
  - added the new `ceph-s3` enum value to the `buckets/items/type` response property for the response status `200`
  - added the new `hw-obs` enum value to the `buckets/items/type` response property for the response status `200`

[Change history](https://skmtc.dev/sodafoundation/apis/soda-crystal-api/changes/v1/backends/metadata/get.md)

---

[API](https://skmtc.dev/sodafoundation/apis/soda-crystal-api.md) · [All operations](https://skmtc.dev/sodafoundation/apis/soda-crystal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sodafoundation/soda-crystal-api/revisions/c02dd33a522b/schema)