Skip to main content
GET
/
v2
/
apps
/
{app_id}
/
network
/
errors
Network Errors
curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'
{
  "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 }
      }
    ]
  }
}
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.

​
Request

​
Headers

​
Authorization
string
required
The API key for your account. You can find this in your account settings.

​
Path

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

​
Query

​
start
string
required
ISO 8601 start timestamp for the analysis window.
​
end
string
required
ISO 8601 end timestamp. Must be after start.
​
include_4xx
string
Whether to include 4xx responses alongside 5xx errors. Accepts true or false. Defaults to false.

​
Response

​
status
string
Indicates whether the call was successful.. success if successful, error if not.
​
response
object
Aggregated error breakdown for the window.
{
  "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 }
      }
    ]
  }
}