Network Logs - Square Cloud

GET

apps

{app_id}

network

logs

Network Logs

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.squarecloud.app/v2/apps/{app_id}/network/logs")
  .header("Authorization", "<authorization>")
  .asString();

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": "São Paulo",
        "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 miss rate limit: 10 requests per 60 seconds per owner.

Authorization

string

required

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

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

app_id

string

required

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

start

string

required

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

end

string

required

ISO 8601 end timestamp. Must be after start.

Response

status

string

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

response

array

The contents of the response.

Show Toggle object

timestamp

string

Timestamp of the request in ISO format.

client

object

Information about the client that made the request.

Show Toggle client object

string | null

The client’s IP address.

country

string | null

The client’s country code.

location

string | null

The client’s approximate location.

asn

string

The client’s ASN.

agent

string | null

The client’s user agent.

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.
`UNABLE_TO_FETCH_ANALYTICS`	500	Failed to fetch logs from the edge provider.

Network ErrorsGet an aggregated breakdown of 5xx (and optionally 4xx) edge errors for the application.

Network Logs

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

import requests

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

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.squarecloud.app/v2/apps/{app_id}/network/logs")
  .header("Authorization", "<authorization>")
  .asString();

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": "São Paulo",
        "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"
      }
    }
  ]
}

​Parameters

​Response

​Common errors

Parameters

Response

Common errors