---
title: "List all backends."
method: GET
path: "/v1/{tenantId}/backends"
tags: ["Backend"]
---

# List all backends.

`GET /v1/{tenantId}/backends`

## Query parameters

- `type` 'hw-obs' | 'aws-s3' | 'azure-blob' | 'ceph-s3' | 'gcp-s3' | 'fusionstorage-object' | 'ibm-cos' | 'yig' | 'aws-file' | 'azure-file'
- `name` string
- `region` string
- `offset` integer
- `limit` integer
- `sort` string

## Response `200`

successful operation.

- object
  - `backends` BackendList[]
    - `id` string — The backend ID, generated by server
    - `tenantId` string — The tenant UUID in a multi-tenancy environment.
    - `userId` string — The user UUID in a multi-tenancy environment.
    - `name` string — The backend name specified by user.
    - `type` 'hw-obs' | 'aws-s3' | 'azure-blob' | 'ceph-s3' | 'gcp-s3' | 'fusionstorage-object' | 'ibm-cos' | 'yig' | 'aws-file' | 'azure-file' — The backend type.
    - `region` string
    - `endpoint` string
  - `next` integer

## Other responses

- `401` — Unauthorized. Token not found in header

## Changes

> 33 revisions in range; 3 not diffed.

- **2021-12-27** `b348fb4e977f` — 10 warning, 7 info
  - removed the optional property `backends/items/Access` from the response with the `200` status
  - removed the optional property `backends/items/BucketName` from the response with the `200` status
  - removed the optional property `backends/items/Endpoint` from the response with the `200` status
  - removed the optional property `backends/items/Id` from the response with the `200` status
  - …13 more
- **2020-06-26** `443f565555ae` — 2 warning, 4 info
  - added the new `aws-file` enum value to the `backends/items/Type` response property for the response status `200`
  - added the new `azure-file` enum value to the `backends/items/Type` response property for the response status `200`
  - api tag `Backend` added
  - api tag `backend` removed
  - …2 more
- **2020-06-09** `bec7a127bf7f` — 1 info
  - endpoint added
- **2020-05-03** `f9da14548ae5` — 1 breaking
  - api path removed without deprecation
- **2018-11-01** `56dbe50974ed` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/changes/v1/:tenantId/backends/get.md)

---

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