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

# search network volumes

`POST /api/v0/network_volumes/search/`

Search for available network volume offers with advanced filtering and sorting.

CLI Usage: `vastai search network-volumes <query> [--order <field>]`

## Request body

- object
  - `q` object
    - `verified` object — Display offers where all machines in cluster are verified
    - `order` array[] — Sort fields and directions
      - string[]
    - `limit` integer — Max results to return
    - `reliability2` object — Cluster reliability score (0-1)
    - `inet_down` object — Download bandwidth (MB/s)
    - `inet_up` object — Upload bandwidth (MB/s)
    - `geolocation` object — Cluster location (two letter country code)
    - `disk_bw` object — Disk read bandwidth in MB/s
    - `duration` object — Maximum rental duration in days
    - `storage_cost` object — Storage cost in $/GB/month

## Response `200`

Successful search response

- object
  - `success` boolean
  - `offers` object[]
    - `ask_contract_id` integer — Unique offer ID
    - `disk_space` number — Storage space in GB
    - `inet_up` number — Upload bandwidth (MB/s)
    - `inet_down` number — Download bandwidth (MB/s)
    - `reliability2` number — Cluster reliability score (0-1)
    - `verified` boolean — Cluster verification status
    - `geolocation` string — Geographic location
    - `nw_disk_avg_bw` integer — Average read bw of network disk from machines in cluster
    - `nw_disk_max_bw` integer — Max read bw of network disk from machines in cluster
    - `nw_disk_min_bw` integer — Min read bw of network disk from machines in cluster
    - `start_date` number — start date of offer, in epoch time
    - `end_date` number — end date of offer, in epoch time
    - `storage_cost` number — storage cost in $/GB/month
    - `storage_cost_total` number — total storage cost per hour for rented space

## Other responses

- `400` — Bad request - invalid query parameters
- `401` — Unauthorized - invalid or missing API key
- `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/versions/4ed14f79f796/schema)