ba1ba2f4b919

latestOpenAPI 3.0.3Apache-2.0raw.githubusercontent.com2026-08-10211632.9 KB
Traffic Analytics

Get app traffic overview

Request/bandwidth totals, status-class counts, latency percentiles, and estimated unique visitors for one app, merged across every host it was served on. An app with no data in range returns 200 with every counter zeroed, not 404.

get/api/app/{uuid}/traffic/overview

Path parameters

uuidstring required

Coolify app UUID (or host, for Caddy — see README.md)

Query parameters

fromstring date-time

Start date in ISO 8601 format (UTC timezone). If not provided, defaults to 1970-01-01T00:00:00Z.

tostring date-time

End date in ISO 8601 format (UTC timezone). If not provided, defaults to current time.

Response

App traffic overview

requestsinteger
bytes_ininteger
bytes_outinteger
unique_visitorsinteger

Approximate distinct client IPs (HyperLogLog++ estimate, ~1-2% error)

Example response

{
  "requests": 128340,
  "bytes_in": 15200000,
  "bytes_out": 981000000,
  "status": {
    "s2xx": 124000,
    "s3xx": 3200,
    "s4xx": 1100,
    "s5xx": 40
  },
  "latency": {
    "p50": 42,
    "p95": 210.5,
    "p99": 480
  },
  "unique_visitors": 8421
}