---
title: "GET /v1beta/{tenantId}/docks"
method: GET
path: "/v1beta/{tenantId}/docks"
tags: ["Dock"]
---

# GET /v1beta/{tenantId}/docks

`GET /v1beta/{tenantId}/docks`

Lists information for all storage docks.

## Query parameters

- `limit` integer
- `offset` integer
- `sortDir` 'asc' | 'desc'
- `sortKey` string
- `storageType` 'block' | 'file' | 'object'
- `type` 'provisioner' | 'attacher'
- `status` 'available' | 'unavailable'
- `name` string

## Response `200`

OK

- DockSpec[]
  - `id` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `type` 'provisioner' | 'attacher'
  - `name` string, required
  - `description` string
  - `storageType` 'block' | 'file' | 'object'
  - `status` 'available' | 'unavailable', required
  - `driverName` 'default' | 'lvm' | 'ceph' | 'cinder' | 'huawei_oceanstor_block' | 'huawei_fusionstorage', required
  - `endpoint` string, required
  - `nodeId` string, required
  - `metadata` object

## Other responses

- `401` — NotAuthorized
- `403` — Forbidden
- `500` — An unexpected error occured.

## Changes

- **2020-02-03** `f797fa1d87f7` — 8 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `name`
  - added the new optional `query` request parameter `offset`
  - added the new optional `query` request parameter `sortDir`
  - …4 more
- **2019-11-06** `fd0669e1e56f` — 4 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `500`
- **2018-05-04** `3a7682f5369d` — 4 breaking, 8 warning
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `500`
  - …8 more

[Change history](https://skmtc.dev/sodafoundation/apis/soda-api/changes/v1beta/:tenantId/docks/get.md)

---

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