> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodepick.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/compute — Discover Compute Hosts

> Search and discover available bare metal compute hosts, hardware capacity, and real-time hourly pricing.

The Compute Discovery API allows developers to search available bare metal compute hosts, query capacity and specifications (CPU, RAM, GPU, storage), and evaluate real-time hourly and monthly pricing.

## Endpoint

```
GET https://api.nodepick.ai/api/v1/compute
```

* **Authentication**: Public access (optional Bearer token)

## Query Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `min_cpu` | number | No | Minimum CPU cores required. Defaults to `1`. |
| `min_memory_gb` | number | No | Minimum system RAM in GiB required. Defaults to `1`. |
| `min_storage_gb` | number | No | Minimum disk storage in GiB required. Defaults to `10`. |
| `region` | string | No | Filter by target region or datacenter (e.g. `us-west-1`, `fmt1`). |
| `datacenter` | string | No | Filter by datacenter facility code (e.g. `fmt1`). |
| `status` | string | No | Host status: `"active"` (ready for immediate deployment), `"reserved"`, or `"all"`. Default: `"all"`. |
| `gpu` | boolean | No | Require dedicated GPU (`true`) or CPU-only (`false`). |
| `page` | number | No | 1-based page number when paginating. |
| `limit` | number | No | Number of hosts per page (max `200`). |

## Response

Returns matching hosts with pre-calculated DRF slice pricing:

```json theme={null}
{
  "hosts": [
    {
      "id": "cf848acc-ad75-4cfc-ba16-28f25630becb",
      "status": "active",
      "region": "us-west-1",
      "datacenter": "fmt1",
      "os": "Ubuntu 26.04 LTS",
      "hostname": "fmt1-sr1",
      "cpu": {
        "cores": 24,
        "architecture": "x86_64"
      },
      "memory_gb": 31.8,
      "storage_gb": 548,
      "gpu": {
        "count": 0
      },
      "pricing": {
        "hourly": "0.0060",
        "monthly": "4.41",
        "currency": "USD"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "total_pages": 1,
    "has_more": false
  }
}
```

## Python SDK

```python theme={null}
from nodepick import NodePickClient

client = NodePickClient(api_key="YOUR_API_KEY")

hosts = client.find_compute(
    min_cpu=2,
    min_memory_gb=4.0,
    min_storage_gb=20,
    max_price=30.0,
    region="us-west-1",
    status="active",
)

for host in hosts:
    print(host["id"], host["pricing"]["monthly"])
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.