> ## 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 Errors
> Get an aggregated breakdown of 5xx (and optionally 4xx) edge errors for the application.
Returns aggregated edge error counts for the application over a time window, grouped by status code, time bucket, request path and HTTP method. By default only 5xx responses are included; pass `include_4xx=true` to also count 4xx responses.
Cache miss rate limit: 15 requests per 60 seconds per owner. Returns an empty breakdown when there are no matching errors or when the window precedes the application's creation date.
The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
Because 4xx errors include client-caused hits like scanner probes and expired links, they are excluded by default; enable `include_4xx=true` only when you specifically need that noise, for example while auditing bot traffic. 5xx codes reflect problems at the edge or the application itself, so they are always included.
This endpoint is available on every paid plan, the same as [Network Analytics](/en/api-reference/endpoint/apps/network/analytics). If you need per-request detail instead of aggregated counts, see [Network Logs](/en/api-reference/endpoint/apps/network/logs) (Pro and Enterprise only). For latency instead of error rate, see [Network Performance](/en/api-reference/endpoint/apps/network/performance).
### 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`.
Whether to include 4xx responses alongside 5xx errors. Accepts `true` or `false`. Defaults to `false`.
### Response
Indicates whether the call was successful.. `success` if successful, `error` if not.
Aggregated error breakdown for the window.
High-level totals for the window.
Total number of error responses in the window.
Totals split by HTTP status class.
Total 4xx responses (only populated when `include_4xx=true`).
Total 5xx responses.
Number of requests grouped by each individual HTTP status code observed.
HTTP status code (e.g. `502`, `504`).
Total requests that returned this status code.
Time-bucketed counts across the analysis window.
Bucket start timestamp in ISO 8601 format.
Object keyed by HTTP status code with the count observed in this bucket.
Total errors observed in this bucket.
Paths that produced the most errors during the window.
Request path.
HTTP method.
Total errors for this path/method.
Counts per HTTP status code observed for this path/method.
Aggregated error totals grouped by HTTP method.
HTTP method.
Total errors for this method.
Counts per HTTP status code observed for this method.
```json theme={null}
{
"status": "success",
"response": {
"summary": {
"total": 42,
"by_class": {
"4xx": 0,
"5xx": 42
}
},
"by_status": [
{ "status": 502, "requests": 30 },
{ "status": 504, "requests": 12 }
],
"timeseries": [
{
"date": "2025-12-01T12:00:00.000Z",
"buckets": { "502": 5, "504": 2 },
"total": 7
}
],
"top_paths": [
{
"path": "/api/users",
"method": "GET",
"total": 18,
"by_status": { "502": 15, "504": 3 }
}
],
"by_method": [
{
"method": "GET",
"total": 30,
"by_status": { "502": 22, "504": 8 }
}
]
}
}
```
### Common errors
| Code | HTTP | Meaning |
| ------------------------ | ---- | --------------------------------------------------------------- |
| `INVALID_TIME_RANGE` | 400 | `start`/`end` are missing, malformed, or invert the time range. |
| `UNABLE_TO_FETCH_ERRORS` | 500 | Failed to fetch error data from the edge provider. |