---
title: "search volumes"
method: POST
path: "/api/v0/volumes/search/"
tags: ["Volumes"]
---

# search volumes

`POST /api/v0/volumes/search/`

Search for available volumes based on specified criteria.

CLI Usage: `vastai search volumes <query> [options]`

## Query parameters

- `q` object
  - `limit` integer — Maximum number of results to return

## Request body

- object
  - `limit` integer — Maximum number of results to return

## Response `200`

Success response

- object
  - `offers` VolumeOffer[]
    - `ask_contract_id` integer — Contract ID for the ask
    - `bundle_id` integer — Bundle ID
    - `cpu_arch` string — CPU architecture
    - `cpu_ghz` number — CPU clock speed in GHz
    - `cpu_name` string — CPU model name
    - `cuda_max_good` number — Maximum CUDA version supported
    - `disk_bw` number — Disk bandwidth
    - `disk_name` string — Disk model name
    - `disk_space` number — Available disk space in GB
    - `driver_vers` string — Driver version (deprecated)
    - `driver_version` string — NVIDIA driver version
    - `duration` number — Duration of the contract
    - `end_date` number — End date as Unix timestamp
    - `external` boolean — Whether the volume is external
    - `geolocation` string — Geographic location
    - `geolocode` string — Geographic location code
    - `gpu_arch` string — GPU architecture
    - `host_id` integer — Host ID
    - `id` integer — Unique identifier for the volume offer
    - `inet_down` number — Download internet speed in Mbps
    - `inet_up` number — Upload internet speed in Mbps
    - `machine_id` integer — Machine ID
    - `mobo_name` string — Motherboard model name
    - `reliability` number — Reliability score
    - `reliability2` number — Alternative reliability score
    - `reliability_mult` number — Reliability multiplier
    - `start_date` number — Start date as Unix timestamp
    - `static_ip` boolean — Whether the machine has a static IP
    - `storage_cost` number — Storage cost
    - `storage_total_cost` number — Total storage cost
    - `vericode` string — Verification code
    - `verification` string — Verification status
    - `vms_enabled` boolean — Whether VMs are enabled

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)