GET /nodes/{id} — Get nodepick.ai Compute Node Details

Use this endpoint to retrieve the current state of a specific node. It is especially useful for polling after you create a node — once status changes from provisioning to running, the ip_address field will contain the public IP you need to connect to the node. You can also use it to confirm a node has fully transitioned to deleting after you call the delete endpoint.

Endpoint

GET https://api.nodepick.ai/nodes/{id}

Path Parameters

string

required

The unique node ID returned in the response body when you created the node with POST /nodes. Example: node_abc123

Request Example

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

Response

A successful request returns HTTP 200 OK with a JSON object describing the current state of the node.

string

The unique identifier for the node, matching the id you passed in the path.

string

The current lifecycle status of the node. Possible values are:

Show Status values

provisioning — The node is being set up and is not yet reachable.
running — The node is live and accepting connections.
deleting — A delete request has been received and the node is being torn down.

string

The node’s public IP address. This field is populated once the node reaches running status. It will be null while the node is still provisioning.

string

The ISO 8601 timestamp recording when the node was originally created.

Response Example

{
  "id": "node_abc123",
  "status": "running",
  "ip_address": "203.0.113.42",
  "created_at": "2024-01-15T10:30:00Z"
}

Python SDK

The get_node_details() method on the nodepick.ai client wraps this endpoint:

details = client.get_node_details("node_abc123")
print(details["ip_address"])  # 203.0.113.42
print(details["status"])      # running

Error Responses

Code	Description
`401`	Unauthorized — your API key is missing or invalid.
`404`	Not found — no node with the given ID exists on your account. Verify the ID and try again.

Overview

Nodes

GET /nodes/{id} — Get nodepick.ai Compute Node Details

Endpoint

Path Parameters

Request Example

Response

Response Example

Python SDK

Error Responses

​Endpoint

​Path Parameters

​Request Example

​Response

​Response Example

​Python SDK

​Error Responses

Endpoint

Path Parameters

Request Example

Response

Response Example

Python SDK

Error Responses