Get Database by ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/databases/{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.vertracloud.app/v1/databases/{id}",
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}"
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}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}")
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": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"use_credits": false,
"credits_used": 0,
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
Databases
Get Database by ID
Retrieves details of a specific database by its ID.
GET
/
v1
/
databases
/
{id}
Get Database by ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/databases/{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.vertracloud.app/v1/databases/{id}",
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}"
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}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}")
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": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"use_credits": false,
"credits_used": 0,
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
The ID of the database to retrieve. If the database belongs to an workspace, include the workspace_id in the format
dbId-workspace_id.Response
The details of the database.
Show Toggle object
Show Toggle object
The ID of the database.
The cluster ID where the database is hosted.
The type of the database.
The name of the database.
The description of the database.
The ID of the database owner.
The ID of the owner’s plan.
The status of the database (e.g.,
up).The RAM allocated to the database in MB.
The host address of the database.
The port used by the database.
The timestamp when the database was created.
The timestamp when the database was last updated.
Whether the database uses credits.
The amount of credits used by the database.
The timestamp since the database went offline, if applicable.
The timestamp of the last snapshot, if available.
{
"response": {
"id": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"use_credits": false,
"credits_used": 0,
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
Error Responses
The error code indicating the reason for failure. Possible values:
UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.DATABASE_NOT_FOUND: The specified database does not exist or the user lacks access.
A descriptive message providing additional details about the error.
{
"code": "UNAUTHORIZED"
}
{
"code": "DATABASE_NOT_FOUND"
}
⌘I