# Get

read the specified volume

## HTTP Request

`GET /api/v1/hyper/volumes/{name}`

## Query Parameters

| Parameter | Description     |
| --------- | --------------- |
| name      | The volume name |

## Response

| Code                                                                                                   | Description  |
| ------------------------------------------------------------------------------------------------------ | ------------ |
| 200 [*VolumeResponse*](https://hyperhq.gitbook.io/pi-docs/reference/api-v1.9/volume/..#volumeresponse) | OK           |
| 400                                                                                                    | Bad Request  |
| 404                                                                                                    | Not Found    |
| 500                                                                                                    | Server Error |

```
{
  "name": "vol1",
  "size": 2,
  "zone": "gcp-us-central1-a",
  "pod": "mysql",
  "createdAt": "2018-04-18T07:17:04.242Z"
}
```