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