Get Database Status by ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/statusimport requests
url = "https://api.vertracloud.app/v1/databases/{id}/status"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/databases/{id}/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.vertracloud.app/v1/databases/{id}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.vertracloud.app/v1/databases/{id}/status"
req, _ := http.NewRequest("GET", url, nil)
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.vertracloud.app/v1/databases/{id}/status")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"id": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
Databases
Get Database Status by ID
Retrieves the current status and resource usage of a database by its ID.
GET
/
v1
/
databases
/
{id}
/
status
Get Database Status by ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/statusimport requests
url = "https://api.vertracloud.app/v1/databases/{id}/status"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/databases/{id}/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.vertracloud.app/v1/databases/{id}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.vertracloud.app/v1/databases/{id}/status"
req, _ := http.NewRequest("GET", url, nil)
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.vertracloud.app/v1/databases/{id}/status")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"id": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
string
required
The ID of the database to retrieve status for. If the database belongs to a workspace, pass its ID in the
workspace_id query parameter.string
If the database belongs to a workspace, the workspace’s ID. Required for workspace members acting on a database they don’t own.
A stopped database answers
200, not an error. The container of a stopped database does not exist — it is removed on stop — and that is a normal state, not a failure. The API returns 200 with status: "stopped", running: false and every metric zeroed. Only a genuine failure to read the status returns 500.Response
object
The status and resource usage details of the database.
Show Toggle object
Show Toggle object
string
The database ID.
string
CPU usage percentage, already formatted (e.g.,
12.30%).string
RAM usage, already formatted (e.g.,
256.00 MB).string
Storage usage, already formatted (e.g.,
512.00 MB).string
The database’s status:
running or stopped.boolean
Indicates whether the database is currently running.
object
number
The database’s uptime in seconds.
string
The timestamp when the database was created.
string
The timestamp when the database was last updated.
{
"response": {
"id": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
Error Responses
string
The error code indicating the reason for failure. Possible values:
DATABASE_NOT_FOUND: The specified database does not exist.FORBIDDEN: The user does not have permission to access the database.INTERNAL_SERVER_ERROR: The status could not be read. A stopped database is not this case — see the note above.
string
A descriptive message providing additional details about the error.
{
"code": "DATABASE_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
{
"code": "INTERNAL_SERVER_ERROR"
}