Get edge request logs

GET

apps

{app_id}

network

logs

Get edge request logs

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/logs \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "Brazil",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

Returns per-request edge logs (HTTP, country, status, bytes) for the application’s primary domain and any configured custom domain. Maximum retention window is 7 days; the start is clamped to the application’s creation date.

Available only on Pro and Enterprise plans. Cache misses share one limit of 20 requests per 60 seconds per application owner, across the analytics, errors, logs and performance endpoints. Cached responses do not count. During platform-wide busy periods the endpoint may return the most recent cached data for the requested window instead.

string

required

The API key for your account. You can find this in your account settings.

Requires an API key with the apps:read scope. This is a sample of raw, per-request edge traffic, not the application’s own runtime output; for stdout/stderr from the container, see Get Application Logs instead. Each entry captures the client (IP, country, user agent), the request (method, path, query, protocol), and the response (status, content type, cache HIT/MISS) as Cloudflare saw it. Results are cached in 5-minute buckets, the same alignment used by Network Analytics, so repeated polling of a moving window reuses the cached sample instead of re-fetching from the edge on every call. Combine with Network Errors to correlate a spike in 5xx responses with the specific requests that triggered it.

Parameters

string

required

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

string

required

ISO 8601 start timestamp. Cannot be earlier than the application’s creation date or older than 7 days.

string

required

ISO 8601 end timestamp. Must be after start.

Response

string

Indicates whether the call was successful: success if it was, error if not.

array

The contents of the response.

Show Toggle object

string

Timestamp of the request in ISO format.

object

Information about the client that made the request.

Show Toggle client object

string | null

The client’s IP address.

string | null

The client’s country code.

string | null

The client’s country name (e.g. Brazil).

string

The client’s ASN.

string | null

The client’s user agent.

string | null

The client category (e.g. bot, human).

object

Information about the incoming request.

Show Toggle request object

boolean

Whether the request was mitigated by edge protections.

string

HTTP method used.

string

Host header value.

string

Request path.

string | null

Query string.

string

Protocol used (e.g. HTTP/2).

string | null

Referer header value.

object

Information about the response served at the edge.

Show Toggle response object

integer

HTTP status code returned.

string | null

Response content type.

string | null

Cache status (e.g. HIT, MISS).

{
  "status": "success",
  "response": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "Brazil",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

Common errors

Code	HTTP	Meaning
`INVALID_TIME_RANGE`	400	`start`/`end` are missing, malformed, or invert the time range.
`UPGRADE_REQUIRED`	403	Analytics logs are available for Pro and Enterprise plans only.
`RATE_LIMITED`	429	The shared limit of cache misses was reached. Wait and retry.
`UNABLE_TO_FETCH_ANALYTICS`	500	Failed to fetch logs from the edge provider.
`ANALYTICS_BUSY`	503	Edge analytics are temporarily busy. Try again in a minute.

CLI: squarecloud app network logs
SDKs: api.apps.network.logs() (JavaScript), client.apps.network.logs() (Python), c.Apps.Network.Logs() (Go)

Get edge request logs

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/logs \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "Brazil",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

Get started

Account

Applications

Databases

Workspaces

AI

Parameters

Response

Common errors

​Parameters

​Response

​Common errors

​Related

Parameters

Response

Common errors

Related