GET /nodes — List All Your nodepick.ai Compute Nodes

Calling GET /nodes returns every compute node currently associated with your account, regardless of status. The response includes nodes that are still provisioning, actively running, and in the process of being deleted. You can use this endpoint to get a complete picture of your active infrastructure at any point in time.

Endpoint

GET https://api.nodepick.ai/nodes

Parameters

This endpoint requires no path parameters or query parameters. Your API key in the Authorization header is the only input needed.

Request Example

curl -X GET https://api.nodepick.ai/nodes \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

A successful request returns HTTP 200 OK with a JSON array. Each element in the array represents one node on your account.

string

The unique identifier for the node.

string

The current lifecycle status of the node: provisioning, running, or deleting.

string

The node’s public IP address. This value is null for nodes that have not yet reached running status.

string

The ISO 8601 timestamp recording when the node was created.

Response Example

[
  {
    "id": "node_abc123",
    "status": "running",
    "ip_address": "203.0.113.42",
    "created_at": "2024-01-15T10:30:00Z"
  },
  {
    "id": "node_def456",
    "status": "provisioning",
    "ip_address": null,
    "created_at": "2024-01-15T10:35:00Z"
  }
]

Python SDK

The nodepick.ai Python SDK’s get_node_details() method operates on a single node by ID. To list all nodes, call the HTTP API directly using the requests library:

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://api.nodepick.ai/nodes", headers=headers)
nodes = response.json()

for node in nodes:
    print(f"{node['id']}: {node['status']}")

Run this endpoint regularly to audit every node currently running on your account. Because billing is per-second and begins at creation, any node you forgot about will continue to accrue charges until you delete it. Catching orphaned nodes early avoids unexpected costs on your bill.

Error Responses

Code	Description
`401`	Unauthorized — your API key is missing or invalid.

​Endpoint

​Parameters

​Request Example

​Response

​Response Example

​Python SDK

​Error Responses

Endpoint

Parameters

Request Example

Response

Response Example

Python SDK

Error Responses