Skip to main content
POST
Search Volume Offers

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Query Parameters

q
object

Query parameters for filtering volume search results

Body

application/json

The raw search query object (not wrapped in a "q" key).

The body is the search query object itself: each key is a volume offer field name paired with a filter expression {operator: value} (operators: eq, neq, gt, gte, lt, lte, in, notin), plus the special keys documented below. Volume-relevant fields include disk_space, storage_cost, duration, reliability, inet_up and inet_down.

limit
integer

Maximum number of offers to return.

Example:

64

order
string[][]

Sort order: list of [column, direction] pairs, e.g. [["dph_total", "asc"]].

Example:
type
enum<string>

Offer type to search.

Available options:
on-demand,
bid,
reserved
Example:

"on-demand"

disable_bundling
boolean

If true, machines are not bundled into multi-GPU offers.

{key}
object

Filter expression for an offer field: {operator: value}, e.g. {"gte": 2} or {"in": ["RTX 4090", "RTX 5090"]}.

Response

Matching volume offers: {"offers": [...]} with keys including id, storage_cost, disk_space, reliability, etc.

offers
object[]

Array of volume offer objects