Get edge and origin latency

GET

apps

{app_id}

network

performance

Get edge and origin latency

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/performance \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

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}/network/performance', 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}/network/performance",
  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}/network/performance"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/performance")

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": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Returns edge and origin response-time percentiles (p50, p95, p99) for the application over a time window, plus per-country, per-colo and slowest-path breakdowns. Useful for diagnosing latency regressions and identifying which routes or regions are slowest.

Available only on Pro and Enterprise plans. Cache misses share one limit of 20 requests per 60 seconds per application owner, across the analytics, errors, logs and performance endpoints. Cached responses do not count. During platform-wide busy periods the endpoint may return the most recent cached data for the requested window instead.

string

required

The API key for your account. You can find this in your account settings.

Requires an API key with the apps:read scope. Edge latency (edge) measures time-to-first-byte at Cloudflare’s network; origin latency (origin) measures how long the application itself took to respond once the edge reached it. A gap between the two that grows during a window usually points at the application or its cluster node, while both rising together points at network conditions between the client and the edge. This measures network latency, not container resource usage; for CPU, RAM, and bandwidth sampled from the container itself, see Get Application Metrics. Combine colos and countries with Network Analytics to see whether a slow region is also a low-traffic one before prioritizing a fix.

Parameters

string

required

The ID of the application. You can find this in the URL of your application’s dashboard.

string

required

ISO 8601 start timestamp for the analysis window.

string

required

ISO 8601 end timestamp. Must be after start.

Response

string

Indicates whether the call was successful: success if it was, error if not.

object

Latency percentiles and breakdowns for the window.

Show Toggle response object

object

Aggregate latency percentiles across the whole window.

Show Toggle summary object

object

Edge-side latency percentiles in milliseconds.

Show Toggle edge object

integer

50th percentile (median) edge latency.

integer

95th percentile edge latency.

integer

99th percentile edge latency.

object

Origin-side latency percentiles in milliseconds.

Show Toggle origin object

integer

50th percentile (median) origin latency.

integer

95th percentile origin latency.

integer

99th percentile origin latency.

integer

Total number of requests analysed in the window.

array

Latency percentiles bucketed across the analysis window.

Show Toggle timeseries item

string

Bucket start timestamp in ISO 8601 format.

integer

Requests observed in the bucket.

object

Edge p50/p95/p99 for this bucket.

object

Origin p50/p95/p99 for this bucket.

array

Latency breakdown by client country.

Show Toggle countries item

string

Two-letter country code (e.g. BR, US).

integer

Median latency for this country in milliseconds.

integer

95th percentile latency for this country in milliseconds.

integer

Requests served to this country.

array

Latency breakdown by edge colo (data center).

Show Toggle colos item

string

Colo identifier (e.g. GRU, IAD).

string

City where the colo is located.

string

Country where the colo is located.

integer

Median latency at this colo in milliseconds.

integer

95th percentile latency at this colo in milliseconds.

integer

Requests served through this colo.

array

Paths with the highest latency in the window.

Show Toggle slowest_paths item

string

Request path.

integer

95th percentile latency for this path in milliseconds.

integer

99th percentile latency for this path in milliseconds.

integer

Requests observed for this path.

{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Common errors

Code	HTTP	Meaning
`INVALID_TIME_RANGE`	400	`start`/`end` are missing, malformed, or invert the time range.
`UPGRADE_REQUIRED`	403	Performance analytics are available for Pro and Enterprise plans only.
`RATE_LIMITED`	429	The shared limit of cache misses was reached. Wait and retry.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Failed to fetch performance data from the edge provider.
`ANALYTICS_BUSY`	503	Edge analytics are temporarily busy. Try again in a minute.

CLI: squarecloud app network performance
SDKs: api.apps.network.performance() (JavaScript), client.apps.network.performance() (Python), c.Apps.Network.Performance() (Go)

Get edge and origin latency

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/performance \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

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}/network/performance', 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}/network/performance",
  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}/network/performance"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/performance")

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": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Get started

Account

Applications

Databases

Workspaces

AI

Get edge and origin latency

Parameters

Response

Common errors

​Parameters

​Response

​Common errors

​Related

Parameters

Response

Common errors

Related