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

Documentation Index

Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt

Use this file to discover all available pages before exploring further.

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.

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. 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.
{
  "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"
      }
    }
  ]
}