Skip to content
Nodus
Blog

List this account's Spot nodes

GET
/v1/spot/nodes
 
curl --request GET \
  --url https://example.com/v1/spot/nodes \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “ Header Parameters ”
Nodus-Org
string

Organization to select with a user token; API keys are already scoped.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

OK

Media type application/json
Array<object> | null
object
billed_seconds
required
integer format: int64
billing_warning
string
cleaned_at
string format: date-time
cost_so_far
required
number format: double
created_at
required
string format: date-time
end_reason
string
ended_at
required
string | null format: date-time
gpu
required
string
id
required
string
ip
required
string
price_per_node_hr
required
number format: double
provider
required
string
ready_at
required
string | null format: date-time
region
required
string
region_class
string
region_name
string
release_at
string format: date-time
retry_after
integer format: int64
ssh_command
string
ssh_port
required
integer format: int64
ssh_user
required
string
started_at
required
string | null format: date-time
startup_failure_code
string
Allowed values: capacity_unavailable
startup_failure_message
string
status
required
string
Allowed values: provisioning running preempted terminating terminated failed
workspace_id
string
workspace_slot
string
Example 
[
  {
    "startup_failure_code": "capacity_unavailable",
    "status": "provisioning"
  }
]

default

Section titled “ default ”

Spot error or platform authentication failure

Media type application/json
object
current_price
number format: double
error
required
string
message
string
retry_after
integer format: int64
Example generated 
{
  "current_price": 1,
  "error": "example",
  "message": "example",
  "retry_after": 1
}