List Compute Offers

GET /v1/compute/offers

List Compute Offers

cURL

curl --request GET \
  --url https://api.dispersed.com/v1/compute/offers

200

{
  "data": [
    {
      "availability": {
        "available_count": 1,
        "status": "AVAILABLE"
      },
      "hardware_summary": {
        "cpu_cores": 123,
        "gpu_count": 123,
        "gpu_model_label": "<string>",
        "gpu_models": [
          {
            "count": 123,
            "gpu_registry_uuid": "<string>",
            "min_vram_gib": 123,
            "name": "<string>"
          }
        ],
        "gpu_registry_uuid": "<string>",
        "min_gpu_vram_gib": 123,
        "ram_gib": 123,
        "storage_gib": 123
      },
      "offer_id": "<string>",
      "pricing": {
        "hourly_rate_usd": 123,
        "network_pricing_policy_uuid": "<string>",
        "quoted_at": "2023-11-07T05:31:56Z"
      },
      "region_code": "us-west-2"
    }
  ],
  "limit": 123,
  "page": 123,
  "total": 123
}

Query Parameters

limit · integer

Required range: 1 <= x <= 50

Example:

1

page · integer

Required range: 1 <= x <= 9007199254740991

Example:

1

sort · string

Example:

"created_at OR -created_at"

filter[cpu_count] · integer | null

Required range: x >= 0

Example:

"8"

filter[gpu_count] · integer | null

Required range: x >= 0

Example:

"1"

filter[gpu_name] · string

Example:

"RTX 4090"

filter[gpu_registry_uuid] · string<uuid>

Example:

"019582a6-27fc-731d-af0a-594f04d6d0d5"

filter[max_hourly_rate_usd] · number | null

Restricts offers to quoted hourly rates at or below this USD ceiling.

Required range: x >= 0

Example:

"1.25"

filter[min_vram_gb] · integer | null

Required range: x >= 0

Example:

"24"

filter[min_ram_gb] · integer | null

Required range: x >= 0

Example:

"64"

filter[min_storage_gb] · integer | null

Required range: x >= 0

Example:

"100"

filter[allowed_region_codes] · string

Restricts offers to nodes whose response region_code is in this comma-separated allowlist. This is intersected with the requester`s workspace and consumer-profile policies.

Example:

"us-west-1,us-west-2"

filter[workload_image] · string

Docker image used to apply workload-specific node cooldown exclusions. Omit for generic catalog behavior.

Example:

"ubuntu"

filter[workload_tag] · string

Docker image tag used with workload_image for workload-specific node cooldown exclusions. Defaults to latest when omitted.

Example:

"24.04"

Response

200

application/json

List of compute offers

data · object[] · required

Show child attributes

limit · integer · required

page · integer · required

total · integer · required