OpenAPI 3.0.3Apache-2.0raw.githubusercontent.com2026-08-12231737.0 KB

f939ccc82c4e

Traffic Analytics

Get app dimension breakdown

Top values of one dimension for one app, summed across every bucket in range. A synthetic __other__ entry absorbs the long tail past the server's top-N cap (TRAFFIC_TOPN). An unrecognized dimension returns an empty array, not an error.

get/api/app/{uuid}/traffic/breakdown/{dimension}

Path parameters

uuidstring required

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

dimensionstring required

One of: status, method, country, referer, browser, os, device, protocol, scheme, tls, cache, bot, agent, ip, useragent. The agent dimension holds the bot/AI-agent name (e.g. GPTBot, ClaudeBot) and is only present for bot traffic. ip holds the resolved real client IP (respecting Cloudflare CF-Connecting-IP and X-Forwarded-For); useragent holds the raw User-Agent header.

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.

limitinteger

Number of ranked entries to return, applied after summing across buckets. Defaults to 50, capped at 1000.

Response

Top values of the dimension for the app

valuestring

requestsinteger

bytes_outinteger

Example response

[
  {
    "value": "US",
    "requests": 42000,
    "bytes_out": 320000000
  }
]