---
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

---

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