> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Network Performance
> Get edge and origin latency percentiles with country, colo and path breakdowns for the application.
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 miss rate limit: 10 requests per 60 seconds per owner.
The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
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](/en/api-reference/endpoint/apps/metrics). Combine `colos` and `countries` with [Network Analytics](/en/api-reference/endpoint/apps/network/analytics) to see whether a slow region is also a low-traffic one before prioritizing a fix.
### Parameters
The ID of the application. You can find this in the URL of your application's dashboard.
ISO 8601 start timestamp for the analysis window.
ISO 8601 end timestamp. Must be after `start`.
### Response
Indicates whether the call was successful.. `success` if successful, `error` if not.
Latency percentiles and breakdowns for the window.
Aggregate latency percentiles across the whole window.
Edge-side latency percentiles in milliseconds.
50th percentile (median) edge latency.
95th percentile edge latency.
99th percentile edge latency.
Origin-side latency percentiles in milliseconds.
50th percentile (median) origin latency.
95th percentile origin latency.
99th percentile origin latency.
Total number of requests analysed in the window.
Latency percentiles bucketed across the analysis window.
Bucket start timestamp in ISO 8601 format.
Requests observed in the bucket.
Edge `p50`/`p95`/`p99` for this bucket.
Origin `p50`/`p95`/`p99` for this bucket.
Latency breakdown by client country.
ISO country code (e.g. `BR`, `US`).
Median latency for this country in milliseconds.
95th percentile latency for this country in milliseconds.
Requests served to this country.
Latency breakdown by edge colo (data center).
Colo identifier (e.g. `GRU`, `IAD`).
City where the colo is located.
Country where the colo is located.
Median latency at this colo in milliseconds.
95th percentile latency at this colo in milliseconds.
Requests served through this colo.
Paths with the highest latency in the window.
Request path.
95th percentile latency for this path in milliseconds.
99th percentile latency for this path in milliseconds.
Requests observed for this path.
```json theme={null}
{
"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. |
| `UNABLE_TO_FETCH_PERFORMANCE` | 500 | Failed to fetch performance data from the edge provider. |