Get a private network
curl --request GET \
--url https://api.ornn.com/v1/orchestrator/networks/{network_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ornn.com/v1/orchestrator/networks/{network_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ornn.com/v1/orchestrator/networks/{network_id}', 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://api.ornn.com/v1/orchestrator/networks/{network_id}",
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://api.ornn.com/v1/orchestrator/networks/{network_id}"
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))
}HttpResponse<String> response = Unirest.get("https://api.ornn.com/v1/orchestrator/networks/{network_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ornn.com/v1/orchestrator/networks/{network_id}")
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{
"id": "88888888-8888-4888-8888-888888888888",
"name": "research",
"cidr": "10.20.0.0/16",
"status": "active",
"endpoint": "203.0.113.10",
"public_key": "exampleGatewayPublicKeyBase64AAAAAAAAAAAAA=",
"attached_reservation_count": 0,
"gateway": {
"status": "active",
"endpoint": "203.0.113.10",
"public_key": "exampleGatewayPublicKeyBase64AAAAAAAAAAAAA="
},
"compartments": [
{
"network_id": "88888888-8888-4888-8888-888888888888",
"compartment_id": "provision_key",
"status": "completed",
"error": null
}
],
"created_at": "2026-10-14T12:00:00Z",
"updated_at": "2026-10-14T12:10:00Z"
}{
"code": "<string>",
"detail": "<string>"
}{
"code": "<string>",
"detail": "<string>"
}{
"detail": {
"code": "network_not_found",
"message": "Ornn could not find that network. It may have been deleted. Refresh and choose another."
}
}{
"code": "<string>",
"detail": "<string>"
}Get a private network
Returns one network. Poll this after creation until status is active, or after deletion until it returns 404. compartments lists the provisioning or teardown steps and their status.
GET
/
v1
/
orchestrator
/
networks
/
{network_id}
Get a private network
curl --request GET \
--url https://api.ornn.com/v1/orchestrator/networks/{network_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ornn.com/v1/orchestrator/networks/{network_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ornn.com/v1/orchestrator/networks/{network_id}', 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://api.ornn.com/v1/orchestrator/networks/{network_id}",
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://api.ornn.com/v1/orchestrator/networks/{network_id}"
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))
}HttpResponse<String> response = Unirest.get("https://api.ornn.com/v1/orchestrator/networks/{network_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ornn.com/v1/orchestrator/networks/{network_id}")
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{
"id": "88888888-8888-4888-8888-888888888888",
"name": "research",
"cidr": "10.20.0.0/16",
"status": "active",
"endpoint": "203.0.113.10",
"public_key": "exampleGatewayPublicKeyBase64AAAAAAAAAAAAA=",
"attached_reservation_count": 0,
"gateway": {
"status": "active",
"endpoint": "203.0.113.10",
"public_key": "exampleGatewayPublicKeyBase64AAAAAAAAAAAAA="
},
"compartments": [
{
"network_id": "88888888-8888-4888-8888-888888888888",
"compartment_id": "provision_key",
"status": "completed",
"error": null
}
],
"created_at": "2026-10-14T12:00:00Z",
"updated_at": "2026-10-14T12:10:00Z"
}{
"code": "<string>",
"detail": "<string>"
}{
"code": "<string>",
"detail": "<string>"
}{
"detail": {
"code": "network_not_found",
"message": "Ornn could not find that network. It may have been deleted. Refresh and choose another."
}
}{
"code": "<string>",
"detail": "<string>"
}CLI equivalent:
ornn private-networks show <name-or-id>.Authorizations
Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.
Path Parameters
Private network ID.
Response
The network.
Private IPv4 range of the network.
pending, active, degraded, or deleting. Use the network only when active.
Gateway public address once provisioned.
Gateway WireGuard public key once provisioned.
Peers connected to the network, including WireGuard configs and machines. Deletion requires 0.
Show child attributes
Show child attributes
Provisioning or teardown steps for the current operation.
Show child attributes
Show child attributes
Was this page helpful?