> ## Documentation Index > Fetch the complete documentation index at: https://www.latitude.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve volume > Shows details of a specific volume. ## OpenAPI ````yaml https://spec.speakeasy.com/latitude/latitude/latitude-sh-api-with-code-samples get /storage/volumes/{id} openapi: 3.0.1 info: title: Latitude.sh API version: '2023-06-01' description: >- The Latitude.sh API is a RESTful API to manage your Latitude.sh account. It allows you to perform the same actions as the Latitude.sh dashboard. servers: - url: https://api.latitude.sh variables: latitude_api_key: default: - url: http://api.latitude.sh variables: latitude_api_key: default: security: [] tags: - name: API keys - name: Baselines (Preview) description: >- Preview. Available to teams with the `baselines_api` feature flag. The shape of these endpoints may change before general availability. - name: Billing - name: Elastic Ips - name: Events - name: Firewalls - name: IP Addresses - name: Managed Databases description: Managed database instances (PostgreSQL, ClickHouse) - name: Kubernetes Clusters - name: LKS - name: Marketplace apps - name: Operating Systems - name: Plans - name: Public Networks - name: Private Networks - name: Projects - name: Regions - name: Roles - name: SSH Keys - name: Servers - name: Block Storage - name: Filesystem Storage - name: Object Storage - name: Tags - name: Teams - name: Team members - name: Traffic - name: User data - name: User profile - name: VPN Sessions - name: Virtual machines - name: Virtual machine backups - name: Virtual machine restores paths: /storage/volumes/{id}: get: tags: - Block Storage summary: Retrieve volume description: Shows details of a specific volume. operationId: retrieve-volume parameters: - name: id in: path required: true description: The volume ID examples: Success: value: vol_aKXgRdR3qv9k5 schema: type: string responses: '200': description: Success content: application/vnd.api+json: examples: Success: value: data: id: vol_aKXgRdR3qv9k5 type: volumes attributes: name: Synergistic Concrete Shoes size_in_gb: 1500 created_at: '2026-01-14T14:57:09.251Z' namespace_id: '1' connector_id: nqn.2001-07.com.latitudesh:1757602476548 initiators: - nqn: >- nqn.2014-08.org.nvmexpress:uuid:ae717767-c0fa-56f7-ab4b-5c426b0c553f region: city: London 1 country: United Kingdom 1 site: id: loc_ROlWJ8XlqNkzr name: London 1 slug: LON facility: London 1 project: id: proj_5AEmq7XyDBkWX name: Sleek Wool Computer slug: sleek-wool-computer description: Awesome Marble Wallet billing_type: Normal billing_method: Normal bandwidth_alert: false environment: null billing: subscription_id: null type: Normal method: Normal stats: databases: 0 ip_addresses: 0 prefixes: 0 servers: 0 storages: 1 virtual_machines: 0 vlans: 0 team: id: team_2KyxrrLkeRtKVLNKv5yNhMWXPnyw name: 623 Team slug: 623-team description: 623 Team address: Apt. 955 6672 Otto Mountain, Phillipfurt, CA 84225 status: verified currency: id: cur_AW6Q2D9lqKLpr code: BRL name: Brazilian Real currency_id: null schema: type: object properties: data: $ref: '#/components/schemas/volume_data' security: - Bearer: [] x-codeSamples: - lang: python label: Python (SDK) source: |- from latitudesh_python_sdk import Latitudesh import os with Latitudesh( bearer=os.getenv("LATITUDESH_BEARER", ""), ) as latitudesh: res = latitudesh.block_storage.get_storage_volume(id="vol_aKXgRdR3qv9k5") # Handle response print(res) - lang: go label: Go (SDK) source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tlatitudeshgosdk \"github.com/latitudesh/latitudesh-go-sdk\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := latitudeshgosdk.New(\n latitudeshgosdk.WithSecurity(os.Getenv(\"LATITUDESH_BEARER\")),\n )\n\n res, err := s.BlockStorage.RetrieveVolume(ctx, \"vol_aKXgRdR3qv9k5\")\n if err != nil {\n log.Fatal(err)\n }\n if res.Object != nil {\n // handle response\n }\n}" - lang: typescript label: Typescript (SDK) source: |- import { Latitudesh } from "latitudesh-typescript-sdk"; const latitudesh = new Latitudesh({ bearer: process.env["LATITUDESH_BEARER"] ?? "", }); async function run() { const result = await latitudesh.blockStorage.getStorageVolume({ id: "vol_aKXgRdR3qv9k5", }); console.log(result); } run(); components: schemas: volume_data: type: object properties: id: type: string type: type: string enum: - volumes attributes: type: object properties: name: type: string size_in_gb: type: integer created_at: type: string format: date-time nullable: true namespace_id: type: integer nullable: true connector_id: type: string nullable: true initiators: type: array items: type: object properties: nqn: type: string nullable: true block: type: object nullable: true description: >- NVMe-TCP block mapping of a high performance volume. Null for volumes that are not mapped to a server. properties: status: type: string nullable: true description: >- Mapping lifecycle state: "mapping" while the mapping is being applied, "mapped" once the server can access the volume, "unmapping" while the mapping is being removed, or "failed". Mapping and unmapping are asynchronous, so poll the volume until this reaches a terminal state. The block object becomes null once the volume is fully unmapped. nqn: type: string nullable: true description: NVMe Qualified Name of the mapped server. nsid: type: integer nullable: true description: NVMe namespace ID of the mapping. server_id: type: string nullable: true description: ID of the server the volume is mapped to. storage_network: type: object nullable: true description: >- Storage network the mapped server joins to reach the volume over NVMe-TCP. Null until the network has been provisioned for the volume. properties: vid: type: integer nullable: true description: VLAN ID of the storage VLAN to tag on the server bond. host_cidr: type: string nullable: true description: >- Storage IP of the mapped server, in CIDR notation. Null until the mapping status is "mapped". gateway: type: string nullable: true description: >- Gateway of the storage network, used for the routes below. routes: type: array items: type: string nullable: true description: >- Storage infrastructure prefixes to route via the gateway. block_gateway: type: string nullable: true description: NVMe-oF/TCP discovery portal address. block_port: type: integer nullable: true description: NVMe-oF/TCP discovery portal port. keyring: type: string nullable: true description: >- Keyring secret used to connect to the volume. Returned only for dashboard-origin requests; null until the volume is provisioned. cluster_user: type: string nullable: true description: >- Cluster user used to connect to the volume. Returned only for dashboard-origin requests; null until the volume is provisioned. volume_path: type: string nullable: true description: >- Path of the volume inside the cluster. Returned only for dashboard-origin requests; null until the volume is provisioned. region: type: object nullable: true properties: city: type: string nullable: true country: type: string nullable: true site: type: object nullable: true properties: id: type: string name: type: string slug: type: string facility: type: string project: $ref: '#/components/schemas/project_include' team: $ref: '#/components/schemas/team_include' project_include: type: object properties: id: type: string name: type: string slug: type: string description: type: string nullable: true billing_type: type: string nullable: true provisioning_type: type: string nullable: true billing_method: type: string nullable: true bandwidth_alert: type: boolean environment: type: string nullable: true billing: type: object properties: subscription_id: type: string nullable: true type: type: string method: type: string stats: type: object properties: databases: type: integer ip_addresses: type: integer prefixes: type: integer servers: type: integer storages: type: integer virtual_machines: type: integer vlans: type: integer team_include: type: object properties: id: type: string name: type: string slug: type: string description: type: string nullable: true address: type: string nullable: true currency: type: object properties: id: type: string code: type: string name: type: string currency_id: type: integer nullable: true status: type: string nullable: true feature_flags: type: array items: type: string limits: type: object properties: bare_metal: type: integer nullable: true bare_metal_gpu: type: integer nullable: true virtual_machine: type: integer nullable: true virtual_machine_gpu: type: integer nullable: true elastic_ip: type: integer nullable: true bgp_session_per_ip: type: integer nullable: true public_network: type: integer nullable: true virtual_network: type: integer nullable: true database: type: integer nullable: true filesystem: type: integer nullable: true block_storage: type: integer nullable: true securitySchemes: Bearer: type: apiKey name: Authorization in: header ````