Application
Get Application Metrics
Get the metrics of your hosted application.
GET
/
v2
/
apps
/
{app_id}
/
metrics
Get Application Metrics
curl --request GET \
--url https://api.squarecloud.app/v2/apps/{app_id}/metrics \
--header 'Authorization: <authorization>'import requests
url = "https://api.squarecloud.app/v2/apps/{app_id}/metrics"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.squarecloud.app/v2/apps/{app_id}/metrics', 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.squarecloud.app/v2/apps/{app_id}/metrics",
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: <authorization>"
],
]);
$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.squarecloud.app/v2/apps/{app_id}/metrics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.squarecloud.app/v2/apps/{app_id}/metrics")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.squarecloud.app/v2/apps/{app_id}/metrics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"response": [
{
"date": "2025-08-13T12:55:01.348Z",
"cpu": 0.45,
"ram": 111.27,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:50:01.349Z",
"cpu": 0.45,
"ram": 111.22,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:45:01.350Z",
"cpu": 0.58,
"ram": 111.36,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:40:01.348Z",
"cpu": 0.43,
"ram": 118.44,
"net": [
16834,
126
]
}
]
}
string
required
The API key for your account. You can find this in your account settings.
status events on Real-time Logs instead.
Metrics collection requires at least 512 MB of RAM allocated to the application; smaller applications return METRICS_NOT_SUPPORTED. Results are cached for 2.5 minutes per (owner, application), and the endpoint is rate limited to 10 requests every 5 seconds per user, with a 60-second block once that cap is hit.
Parameters
string
required
The ID of the application. You can find this in the URL of your application’s dashboard.
Response
string
Indicates whether the call was successful..
success if successful, error if not.array
{
"status": "success",
"response": [
{
"date": "2025-08-13T12:55:01.348Z",
"cpu": 0.45,
"ram": 111.27,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:50:01.349Z",
"cpu": 0.45,
"ram": 111.22,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:45:01.350Z",
"cpu": 0.58,
"ram": 111.36,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:40:01.348Z",
"cpu": 0.43,
"ram": 118.44,
"net": [
16834,
126
]
}
]
}
Common errors
| Code | HTTP | Meaning |
|---|---|---|
METRICS_NOT_SUPPORTED | 400 | The application has less than 512 MB of RAM allocated and does not collect metrics. |
⌘I
Get Application Metrics
curl --request GET \
--url https://api.squarecloud.app/v2/apps/{app_id}/metrics \
--header 'Authorization: <authorization>'import requests
url = "https://api.squarecloud.app/v2/apps/{app_id}/metrics"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.squarecloud.app/v2/apps/{app_id}/metrics', 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.squarecloud.app/v2/apps/{app_id}/metrics",
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: <authorization>"
],
]);
$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.squarecloud.app/v2/apps/{app_id}/metrics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.squarecloud.app/v2/apps/{app_id}/metrics")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.squarecloud.app/v2/apps/{app_id}/metrics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"response": [
{
"date": "2025-08-13T12:55:01.348Z",
"cpu": 0.45,
"ram": 111.27,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:50:01.349Z",
"cpu": 0.45,
"ram": 111.22,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:45:01.350Z",
"cpu": 0.58,
"ram": 111.36,
"net": [
16834,
126
]
},
{
"date": "2025-08-13T12:40:01.348Z",
"cpu": 0.43,
"ram": 118.44,
"net": [
16834,
126
]
}
]
}

