Volumes

Get all volumes

get/v1/volumes

Query parameters

Example:attached

Get volumes with this status. Optional

Response

Returns a list of all volumes

Rate limits

This endpoint is rate limited to 120 requests per minute per project.

idstring required

Volume ID

instance_idstring required

Instance ID

instancesstring[] required

Instance info the volume is attached to

namestring required

Volume name

created_atstring required

Volume creation date

created_by_user_idstring

Volume status

sizenumber required

Volume size in GB

is_os_volumeboolean required

Is OS volume

targetstring required

Volume target

Volume type

locationstring required

Volume location

ssh_key_idsstring[] required

Array of SSH key IDs that are linked to the volume if it is an OS volume

pseudo_pathstring required

Volume pseudo path. Unique identifier for your filesystem

create_directory_commandstring required

Create directory command

mount_commandstring required

Mount command

filesystem_to_fstab_commandstring required

Filesystem to fstab command

contractstring required

Volume contract type

base_hourly_costnumber required

Volume base hourly cost

monthly_pricenumber required

Volume monthly price

currency'usd' | 'eur' required

Volume currency

long_termobject required

Long term contract details

Example response

[
  {
    "id": "93c471c1-0810-49f8-a073-a81f999331b6",
    "instance_id": "d3a79bb2-85da-4921-b1e5-dd21d0da4f82",
    "instances": [
      {
        "id": "d3a79bb2-85da-4921-b1e5-dd21d0da4f82",
        "auto_rental_extension": null,
        "ip": "123.123.123.123",
        "instance_type": "4A100.88V",
        "status": "running",
        "os_volume_id": "514409f3-9b84-4ced-9d92-9a772603f50b",
        "hostname": "hazy-star-swims-fin-01",
        "instance_template": {
          "instance_type": "4A100.88V",
          "cpu_cores": 128,
          "gpu_number": 4,
          "gpu_vram_gb": 80,
          "ram_gb": 512
        },
        "instance_model": {
          "code": "A100_80G",
          "manufacturer": "NVIDIA",
          "category": "GPU",
          "cluster_model_code": null
        }
      }
    ],
    "name": "OS-NVMe-84Ca37Jf",
    "created_at": "2024-07-08T19:19:54.247Z",
    "created_by_user_id": "7dfc2631-0158-4f74-93f6-6b46dcb90fef",
    "status": "attached",
    "size": 100,
    "is_os_volume": true,
    "target": "vda",
    "type": "NVMe",
    "location": "FIN-01",
    "ssh_key_ids": [
      "537f578e-e336-4fee-a034-5397c6955115"
    ],
    "pseudo_path": "volume-84Ca37Jf",
    "create_directory_command": "mkdir -p /mnt/volume",
    "mount_command": "mount -t nfs -o nconnect=16 nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume",
    "filesystem_to_fstab_command": "grep -qxF 'nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume nfs defaults 0 0' /etc/fstab || echo 'nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume nfs defaults 0 0' | sudo tee -a /etc/fstab",
    "contract": "LONG_TERM",
    "base_hourly_cost": 0.0273972602739726,
    "monthly_price": 20,
    "currency": "eur",
    "long_term": {
      "end_date": "2025-01-08T19:34:16.663Z",
      "long_term_period": "3 months",
      "discount_percentage": 14,
      "auto_rental_extension": false,
      "next_period_price": 49.93356,
      "current_period_price": 49.93356
    },
    "tags": [
      {
        "id": "tag_0aB1cD2eF3gH4iJ5kL6mN7",
        "key": "environment",
        "value": "production"
      }
    ]
  }
]

Changes

Changed in 1 of the 11 revisions of this API.1

Aug 11, 2026c6bc656333bd1See the full diff
- ○
  added the required property items/tags to the response with the 200 status
  response-required-property-added

Of the 11 revisions, 1 has no diff computed.

Full history