---
title: "Get edge error breakdown for the application's domains"
method: GET
path: "/v2/apps/{appId}/network/errors"
tags: ["Network"]
---

# Get edge error breakdown for the application's domains

`GET /v2/apps/{appId}/network/errors`

Returns an aggregated view of HTTP errors served at the edge for the application's primary domain and any configured custom domain: status code breakdown, timeseries, top failing paths and per-method breakdown.

Requires both `start` and `end` ISO timestamps. Maximum retention window is 7 days; the start is clamped to the application's creation date.

Defaults to 5xx only. Pass `include_4xx=true` to include 4xx as well (typically noisy with scanner 404s).

Results cached per bucket; on cache miss rate-limited to 15 calls per 60s per owner.

## Path parameters

- `appId` string, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required
- `include_4xx` 'true' | 'false'

## Response `200`

Aggregated error breakdown: status-code summary, time-bucketed totals, top failing (method, path) tuples, and per-method breakdown. The status-code keys inside `timeseries[].buckets`, `top_paths[].by_status`, and `by_method[].by_status` are open — whichever status codes the edge served in the window appear there. Returns empty totals/arrays when the requested window has no matching errors or starts before the application's creation date.

- object
  - `status` 'success', required
  - `response` union, required
    - NetworkErrors
      - `summary` object, required
        - `total` integer, required
        - `by_class` object, required
          - `4xx` integer, required
          - `5xx` integer, required
      - `by_status` object[], required — Flat per-status breakdown. Note: this is an ARRAY of `{ status, requests }`, unlike the nested `by_status` maps inside `top_paths` and `by_method`.
        - `status` integer, required
        - `requests` integer, required
      - `timeseries` NetworkErrorsTimeBucket[], required
        - `date` string, date-time, required
        - `buckets` object, required — Map of HTTP status code (as string) to request count.
        - `total` integer, required
      - `top_paths` NetworkErrorsTopPath[], required
        - `path` string, required
        - `method` string, nullable, required
        - `total` integer, required
        - `by_status` object, required — Map of HTTP status code (as string) to request count for this (method, path).
      - `by_method` NetworkErrorsByMethod[], required
        - `method` string, nullable, required
        - `total` integer, required
        - `by_status` object, required — Map of HTTP status code (as string) to request count for this HTTP method.
    - object — Empty when the window precedes app creation.

## Other responses

- `400` — `start`/`end` are missing, malformed, or invert the time range.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The target application could not be found, or the caller is not a member of the workspace.
- `429` — Cache miss rate limit exceeded (15 per 60s per owner).
- `500` — Failed to fetch errors from the edge provider.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)