Get environment status

Reports what the environment runs now, per region and per revision. Use it to tell whether the current revision’s rollout is complete, and which revisions still have instances that take sessions. Poll this route to follow a rollout.

The status is computed on each read from cluster reports, which can lag by about a minute, and by up to 15 minutes when a cluster stops reporting. observed_at gives the age. An unreadable region does not fail the read; it reports state unknown. Treat any state value you do not recognize as unknown.

Region states: ready (the current revision has its requested instances available and no older instance is left), deploying (instances are being added or drained), pending (no instance of the current revision yet), and unknown. The response has Cache-Control: no-store. Requires the read access of the environment.

GET

projects

{proj_id}

environments

{env}

status

Get environment status

curl --request GET \
  --url https://api.reactor.inc/projects/{proj_id}/environments/{env}/status \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.reactor.inc/projects/{proj_id}/environments/{env}/status"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

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

fetch('https://api.reactor.inc/projects/{proj_id}/environments/{env}/status', 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.reactor.inc/projects/{proj_id}/environments/{env}/status",
  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.reactor.inc/projects/{proj_id}/environments/{env}/status"

	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://api.reactor.inc/projects/{proj_id}/environments/{env}/status")

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

{
  "revision": 3,
  "regions": [
    {
      "region": "us-east",
      "state": "deploying",
      "observed_at": "2026-10-10T09:54:10Z",
      "revisions": [
        {
          "number": 3,
          "requested": 3,
          "available": 1,
          "terminating": 0
        },
        {
          "number": 2,
          "requested": 0,
          "available": 2,
          "terminating": 0
        }
      ]
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Path Parameters

proj_id

string<uuid>

required

The project's ID, a UUID. It is not the model's ID.

env

string

required

The environment's ID (a UUID) or its name, such as production. A name matches only a live environment; a deleted environment is reachable by its ID only.

Response

The environment's status. Before the first revision, revision is null and regions is empty.

revision

integer | null

required

The current revision the status describes. Compare it with the revision a write returned.

regions

object[]

required

One row per region of the current plan, plus any region still running instances of the environment. Sorted by name.

Show child attributes

⌘I

Get environment status

curl --request GET \
  --url https://api.reactor.inc/projects/{proj_id}/environments/{env}/status \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.reactor.inc/projects/{proj_id}/environments/{env}/status"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

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

fetch('https://api.reactor.inc/projects/{proj_id}/environments/{env}/status', 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.reactor.inc/projects/{proj_id}/environments/{env}/status",
  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.reactor.inc/projects/{proj_id}/environments/{env}/status"

	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://api.reactor.inc/projects/{proj_id}/environments/{env}/status")

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

{
  "revision": 3,
  "regions": [
    {
      "region": "us-east",
      "state": "deploying",
      "observed_at": "2026-10-10T09:54:10Z",
      "revisions": [
        {
          "number": 3,
          "requested": 3,
          "available": 1,
          "terminating": 0
        },
        {
          "number": 2,
          "requested": 0,
          "available": 2,
          "terminating": 0
        }
      ]
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Get environment status

Authorizations

Path Parameters

Response