List all instances

GET/compute/{connection_id}/instance

Parameters

Returns

ComputeInstancearray

idstring

Unique identifier for the instance

created_atdate-time

When the instance was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atdate-time

When the instance was last updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring

Display name of the instance

type enum

Valid values:

"CONTAINER"

"VM"

"BAREMETAL"

"SANDBOX"

"OTHER"

The kind of compute unit

status enum

Valid values:

"PROVISIONING"

"STARTING"

"RUNNING"

"STOPPING"

"STOPPED"

"PAUSING"

"PAUSED"

"RESUMING"

"RESTARTING"

"TERMINATING"

"TERMINATED"

"PREEMPTED"

"ERROR"

"OTHER"

Normalized lifecycle status; set on update to start, stop, pause, resume, restart or terminate

status_reasonstring

Vendor explanation of the current status (eg. shutdown or failure reason)

allowed_actions enum array

Valid values:

"START"

"STOP"

"RESTART"

"PAUSE"

"RESUME"

"TERMINATE"

Lifecycle actions the vendor currently allows

market enum

Valid values:

"ON_DEMAND"

"SPOT"

"RESERVED"

"COMMUNITY"

"OTHER"

Pricing market the instance runs in

region_idstring

The region the instance runs in

template_idstring

The template the instance was created from

imagestring

Container or OS image, when not created from a template

source_snapshot_idstring

The snapshot the instance was restored or forked from

parent_instance_idstring

The instance this one was forked from

gputype_idstring

The GPU or instance type of this instance

gpu_model enum

Valid values:

"NVIDIA_GB300"

"NVIDIA_B300"

"NVIDIA_GB200"

"NVIDIA_B200"

"NVIDIA_GH200"

"NVIDIA_H200"

"NVIDIA_H100_SXM"

"NVIDIA_H100_PCIE"

"NVIDIA_H100_NVL"

"NVIDIA_A100_SXM_80GB"

"NVIDIA_A100_PCIE_80GB"

"NVIDIA_A100_40GB"

"NVIDIA_L40S"

"NVIDIA_L40"

"NVIDIA_L4"

"NVIDIA_A40"

"NVIDIA_A10"

"NVIDIA_RTX_PRO_6000"

"NVIDIA_RTX_6000_ADA"

"NVIDIA_RTX_A6000"

"NVIDIA_RTX_A5000"

"NVIDIA_RTX_A4000"

"NVIDIA_RTX_5090"

"NVIDIA_RTX_4090"

"NVIDIA_RTX_3090"

"NVIDIA_V100"

"NVIDIA_T4"

"AMD_MI355X"

"AMD_MI325X"

"AMD_MI300X"

"AMD_MI250"

"OTHER"

Normalized GPU model

gpu_countnumber

Number of GPUs attached (0 for CPU-only)

skustring

The vendor's own SKU or size name

cpu_countnumber

Number of vCPUs; may be fractional

memory_mbnumber

System memory in MiB

disk_mbnumber

Disk size in MiB

architecture enum

Valid values:

"X86_64"

"ARM64"

"OTHER"

CPU architecture

price_amountnumber

List price for the instance

price_unit enum

Valid values:

"PER_GPU_HOUR"

"PER_INSTANCE_HOUR"

"OTHER"

Unit that price_amount is quoted in

currencystring

Currency of price_amount (ISO 4217)

volume_idsstring array

Volumes mounted on the instance

endpoints array

Exposed ports and their URLs

sshobject

SSH connection details

has_internet_accessboolean

Whether outbound network access is allowed

timeout_secondsnumber

Seconds until the instance expires; set on update to extend it

expires_atdate-time

When the instance will expire (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

on_expire enum

Valid values:

"TERMINATE"

"PAUSE"

"STOP"

"OTHER"

What happens when the instance expires

idle_timeout_secondsnumber

Seconds of inactivity before on_idle applies

on_idle enum

Valid values:

"TERMINATE"

"PAUSE"

"STOP"

"OTHER"

What happens when the instance is idle

project_identifierstring

Vendor project, team or app that groups the instance (reference to TaskProject)

service_idstring

The service (app) this instance runs for, on hosting platforms

env array

Environment variables (write-only values)

started_atdate-time

When the instance last started (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

terminated_atdate-time

When the instance was terminated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

metadata array

Vendor labels, tags and metadata

raw

Raw data from integration

Errors

Errors return the HTTP status code and a JSON body with statusCode, error (the short label) and message (a human-readable detail).

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Too many requests to unified.to API; max requests per minute: N"
}

Status	Error	Meaning
`400`	Bad Request	The request was malformed or failed validation.
`401`	Unauthorized	The connection is likely broken; re-authorize it.
`403`	Forbidden	The connection is missing permissions or scopes.
`404`	Not Found	The requested resource does not exist.
`429`	Too Many Requests	Rate limit exceeded (see the two sources below).
`500`	Internal Server Error	An unexpected error occurred.
`501`	Not Implemented	Not supported by this integration.

Errors from the underlying integration pass through: the integration's status comes back as ours (429, 401, 403, 404 or 5xx), usually with its message. When the integration's error body is unclear, Unified extracts what it can and returns a clearer message.

429 Too Many Requests

A 429 has two possible sources:

The integration's own rate limit, passed through.
Unified's workspace limit: a rolling 60 seconds, set by plan, with the message Too many requests to unified.to API; max requests per minute: N.

const options = {
  method: 'GET',
  url: 'https://api.unified.to/compute/5de520f96e439b002043d8dc/instance',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-10-11T18:29:33.421Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    status: '',
    type: '',
    region_id: '',
    template_id: '',
    service_id: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);

Code Samples

Node.js SDK

import { UnifiedTo } from '@unified-api/typescript-sdk';

const sdk = new UnifiedTo({
    security: {
        jwt: '<YOUR_API_KEY_HERE>',
    },
});

const connectionId = '5de520f96e439b002043d8dc';

const results = await sdk.compute.listComputeInstances({ connectionId, 
    limit: 50,
    offset: 0,
    updated_gte: '2026-10-11T18:29:33.421Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    status: '',
    type: '',
    region_id: '',
    template_id: '',
    service_id: '',
    fields: '',
    raw: '',
 });

Node.js (axios)

const options = {
  method: 'GET',
  url: 'https://api.unified.to/compute/5de520f96e439b002043d8dc/instance',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-10-11T18:29:33.421Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    status: '',
    type: '',
    region_id: '',
    template_id: '',
    service_id: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);

Java

AsyncHttpClient client = new DefaultAsyncHttpClient();

client.prepare("GET", "https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw=")
  .setHeader("accept", "application/json")
  .setHeader("authorization", ".....")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();

Go

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

url := `https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw=

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("accept", "application/json")
req.Header.Add("authorization", ".....")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)

Python

import requests

url = "https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw="

headers = {
    "accept": "application/json",
    "authorization": "....."
}

response = requests.get(url, headers=headers)

PHP

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: ....."
  ],
]);

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = '....'

response = http.request(request)
puts response.read_body

cURL

curl --request GET \
  --url 'https://api.unified.to/compute/5de520f96e439b002043d8dc/instance?limit=50&offset=0&updated_gte=2026-10-11T18:29:33.421Z&sort=updated_at&order=asc&query=&status=&type=&region_id=&template_id=&service_id=&fields=&raw=' \
  --header 'accept: application/json' \
  --header 'authorization: .....'

Are we missing anything? Let us know

Was this page helpful?