Application Details
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}import requests
url = "https://api.vertracloud.app/v1/apps/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/apps/{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/apps/{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/apps/{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/apps/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/apps/{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": "app-abc123def456",
"cluster": 1,
"type": 1,
"name": "API Simples",
"description": "I have a description :)",
"owner_id": "user-123456789012345678",
"owner_plan_id": 1,
"language": "javascript",
"ram": 128,
"status": "up",
"subdomain": "myapp.vertraweb.app",
"custom_domain": null,
"public_url": "https://myapp.vertraweb.app",
"last_snapshot": "2026-03-09T15:51:47.234Z",
"main_file": "index.js",
"version": "recommended",
"start_command": "node index.js",
"build_command": null,
"offline_since": null,
"shield_cooldown": null,
"github": null,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-20T15:06:41.449Z"
}
}
Applications
Application Details
Retrieves detailed information about an application by its ID.
GET
/
v1
/
apps
/
{id}
Application Details
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}import requests
url = "https://api.vertracloud.app/v1/apps/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.vertracloud.app/v1/apps/{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/apps/{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/apps/{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/apps/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/apps/{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": "app-abc123def456",
"cluster": 1,
"type": 1,
"name": "API Simples",
"description": "I have a description :)",
"owner_id": "user-123456789012345678",
"owner_plan_id": 1,
"language": "javascript",
"ram": 128,
"status": "up",
"subdomain": "myapp.vertraweb.app",
"custom_domain": null,
"public_url": "https://myapp.vertraweb.app",
"last_snapshot": "2026-03-09T15:51:47.234Z",
"main_file": "index.js",
"version": "recommended",
"start_command": "node index.js",
"build_command": null,
"offline_since": null,
"shield_cooldown": null,
"github": null,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-20T15:06:41.449Z"
}
}
string
required
The application ID to retrieve details. If the application belongs to a workspace, pass its ID in the
workspace_id query parameter.string
If the application belongs to a workspace, the workspace’s ID. Required for workspace members acting on an application they don’t own.
Response
object
The application details.
Show Toggle object
Show Toggle object
string
The application ID.
integer
The application cluster ID.
integer
The application type.
string
The application name.
string
The application description.
string
The application owner ID.
integer
The owner’s plan ID.
string
The application programming language (e.g.,
javascript).integer
The application RAM in MB.
string
The application status (e.g.,
up).string | null
The application subdomain, if applicable.
string | null
The custom domain of the application, if applicable.
string | null
The application’s canonical public URL, already computed by the server from
custom_domain
and subdomain (null when the app has neither, i.e. it is not web-published). Build links
from this field, never from subdomain directly — a self-hosted deployment behind a
non-standard edge may return a different host or scheme here.string | null
The timestamp of the application’s last snapshot.
string
The main file of the application.
string
The runtime version (e.g.,
recommended or latest).string | null
The startup command for the application, if specified.
string | null
The build command, if specified. Runs after dependency installation and before the
application starts, in an isolated build environment.
null when no build command is set.string | null
The timestamp since the application went offline, if applicable.
object | null
Present while Vertra Shield has paused the application. Includes
until (the cooldown end time),
reason (burst or rate_limit), and direction (in or out); null when no cooldown is active.object | null
Linked GitHub repository (
repo_owner, repo_name) when auto-deploy is connected; null
when the app was created from a zip or snapshot. The webhook URL is not included — use
GET /v1/apps/{id}/deploys/webhook for that.string
The timestamp when the application was created.
string
The timestamp when the application was last updated.
{
"response": {
"id": "app-abc123def456",
"cluster": 1,
"type": 1,
"name": "API Simples",
"description": "I have a description :)",
"owner_id": "user-123456789012345678",
"owner_plan_id": 1,
"language": "javascript",
"ram": 128,
"status": "up",
"subdomain": "myapp.vertraweb.app",
"custom_domain": null,
"public_url": "https://myapp.vertraweb.app",
"last_snapshot": "2026-03-09T15:51:47.234Z",
"main_file": "index.js",
"version": "recommended",
"start_command": "node index.js",
"build_command": null,
"offline_since": null,
"shield_cooldown": null,
"github": null,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-20T15:06:41.449Z"
}
}
Error Responses
string
The error code indicating the reason for the failure. Possible values:
UNAUTHORIZED: The user is not authenticated or does not have sufficient permissions.APP_NOT_FOUND: The specified application does not exist.
string
A descriptive message providing additional details about the error.
{
"code": "APP_NOT_FOUND"
}
{
"code": "UNAUTHORIZED"
}