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

# Get per-request edge logs for the application's domains

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

Returns per-request edge logs (HTTP, country, status, bytes) for the application's primary domain and any configured custom domain.

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

Results cached per bucket; on cache miss rate-limited to 10 calls per 60s per owner. Available only on Pro and Enterprise plans.

## Path parameters

- `appId` string, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required

## Response `200`

Per-request edge log entries.

- object
  - `status` 'success', required
  - `response` object[], required
    - `timestamp` string, date-time, required
    - `client` object, required
      - `ip` string, nullable, required
      - `country` string, nullable, required
      - `location` string, nullable, required
      - `asn` string, required
      - `agent` string, nullable, required
      - `category` string, nullable, required
    - `request` object, required
      - `mitigated` boolean, required
      - `method` string, required
      - `host` string, required
      - `path` string, required
      - `query` string, nullable, required
      - `protocol` string, required
      - `referer` string, nullable, required
    - `response` object, required
      - `status` integer, required
      - `contentType` string, nullable, required
      - `cache` string, nullable, required

## 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.
- `403` — The active plan does not include analytics logs. Upgrade to Pro or Enterprise.
- `404` — The target application could not be found, or the caller is not a member of the workspace.
- `429` — Cache miss rate limit exceeded (10 per 60s per owner).
- `500` — Failed to fetch logs 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)