Orgo - Cloud computers for AI agents

GET

computers

{id}

residential-proxy

Get residential IP status

curl --request GET \
  --url https://www.orgo.ai/api/computers/{id}/residential-proxy \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/computers/{id}/residential-proxy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/residential-proxy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/residential-proxy"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/residential-proxy")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "proxy_on": true,
  "exit_ip": "203.0.113.24",
  "country": "us",
  "quota": {
    "granted_bytes": 5368709120,
    "used_bytes": 1288490188,
    "remaining_bytes": 4080218932
  }
}

Returns whether this computer’s Google Chrome goes out through a residential IP, the last exit IP Orgo saw, and the account’s residential data.

curl "https://www.orgo.ai/api/computers/$COMPUTER_ID/residential-proxy" \
  -H "Authorization: Bearer $ORGO_API_KEY"

Replace $COMPUTER_ID with the computer’s UUID.

Check the exit IP now

Add ?check=1 to test the route or see whether the IP has moved. The computer reads its exit IP through the proxy, and exit_ip is that reading. The answer adds changed, which is true when the reading differs from the last exit IP Orgo saw, and checked_at.

curl "https://www.orgo.ai/api/computers/$COMPUTER_ID/residential-proxy?check=1" \
  -H "Authorization: Bearer $ORGO_API_KEY"

{
  "proxy_on": true,
  "exit_ip": "203.0.113.24",
  "country": "us",
  "quota": {
    "granted_bytes": 5368709120,
    "used_bytes": 1288490188,
    "remaining_bytes": 4080218932
  },
  "changed": false,
  "checked_at": "2026-11-03T18:20:00.000Z"
}

You can check 6 times a minute per computer. Past that the answer is 429 with the code rate_limited. A check spends a few KB of the account’s data. A check answers 409 when the proxy is off, when the computer is asleep (code computer_asleep), or when no reading came back. The IP on record stands, so try again. An IP lasts up to 2 hours and can change sooner, as How long a residential IP lasts explains.

Read the data left

quota is the workspace owner’s residential data, shared by every computer in the account. It is DataImpulse’s count as of Orgo’s last hourly sync, so it can be up to an hour behind.

Authorizations

Authorization

string

header

required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

string

required

Computer ID. Accepts the computer's UUID or its instance_id.

Query Parameters

check

enum<string>

1 reads the exit IP through the proxy now and adds changed and checked_at. Omit it to get the last exit IP Orgo saw.

Available options:

1

Response

The status. With ?check=1, exit_ip is that reading.

A computer's residential IP and the account's residential data.

proxy_on

boolean

required

true while this computer's Chrome goes through the proxy.

exit_ip

string | null

required

The last exit IP Orgo saw. null while the proxy is off, or if Orgo could not read one.

country

string

required

The exit country: us.

quota

object

required

The workspace owner's residential data, shared by every computer in the account. DataImpulse's count as of Orgo's last hourly sync, so it can be up to an hour behind.

Show child attributes

changed

boolean

Only with ?check=1: this reading differs from the last exit IP Orgo saw.

checked_at

string<date-time>

Only with ?check=1: when it was read.

Get residential IP status

curl --request GET \
  --url https://www.orgo.ai/api/computers/{id}/residential-proxy \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/computers/{id}/residential-proxy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/residential-proxy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/residential-proxy"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/residential-proxy")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "proxy_on": true,
  "exit_ip": "203.0.113.24",
  "country": "us",
  "quota": {
    "granted_bytes": 5368709120,
    "used_bytes": 1288490188,
    "remaining_bytes": 4080218932
  }
}

Overview

API keys

Support

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get residential IP status

Check the exit IP now

Read the data left

Authorizations

Path Parameters

Query Parameters

Response

​Check the exit IP now

​Read the data left

Authorizations

Path Parameters

Query Parameters

Response

Check the exit IP now

Read the data left