Analytics

Seven endpoints for analytics and reporting.

Loft is a Pro product. These routes are served by the Loft desktop app’s local Bridge on loopback (localhost:5100) for the signed-in user, which resolves the Professional tier locally, so a local call needs no API key. This is not a hosted API and is not reachable from another machine. A request below the Professional tier returns 402, never a hard 403.

GET /api/loft/analytics/timeseries

Query time-series data for an interface.

Query Param	Type	Default	Description
`interfaceId`	string	all	Filter to a specific interface
`since`	ISO 8601	24h ago	Start time
`until`	ISO 8601	Now	End time
`granularity`	string	`"oneHour"`	`oneMinute`, `oneHour`, `oneDay`
`metric`	string	`"messagesTotal"`	`messagesTotal`, `messagesFailed`, `messagesSuccessful`

curl

curl "http://localhost:5100/api/loft/analytics/timeseries?interfaceId=intf-001&granularity=oneHour&since=2026-02-22T00:00:00Z"

GET /api/loft/analytics/topn

Get top N interfaces ranked by a metric.

Query Param	Type	Default	Description
`metric`	string	`"messagesTotal"`	Metric to rank by
`n`	int	`10`	Number of results
`since`	ISO 8601	24h ago	Start time

curl

curl "http://localhost:5100/api/loft/analytics/topn?metric=messagesFailed&n=5"

POST /api/loft/analytics/query

Custom filter query with additional criteria.

curl

curl -X POST http://localhost:5100/api/loft/analytics/query \
  -H "Content-Type: application/json" \
  -d '{"filters": {"interfaceId": "intf-001", "severity": "critical"}, "since": "2026-02-20T00:00:00Z"}'

GET /api/loft/analytics/dashboards/

Get pre-built dashboard data.

curl

curl "http://localhost:5100/api/loft/analytics/dashboards/overview?since=2026-02-15T00:00:00Z"

POST /api/loft/analytics/reports/schedule

Schedule a recurring report.

curl

curl -X POST http://localhost:5100/api/loft/analytics/reports/schedule \
  -H "Content-Type: application/json" \
  -d '{"frequency": "daily", "format": "html", "recipients": ["[email protected]"]}'

POST /api/loft/analytics/reports/generate

Generate a report immediately.

curl

curl -X POST http://localhost:5100/api/loft/analytics/reports/generate \
  -H "Content-Type: application/json" \
  -d '{"format": "html", "since": "2026-02-15T00:00:00Z"}'

GET /api/loft/analytics/export/csv

Export analytics data as CSV.

Query Param	Type	Default	Description
`interfaceId`	string	all	Interface to export
`since`	ISO 8601	24h ago	Start time
`until`	ISO 8601	Now	End time
`granularity`	string	`"oneHour"`	Data resolution
`metric`	string	`"messagesTotal"`	Metric to export

curl

curl "http://localhost:5100/api/loft/analytics/export/csv?interfaceId=intf-001&granularity=oneDay" \
  -o metrics.csv

Overview

Core APIs

Loft APIs

Flock APIs

Live Updates

GET /api/loft/analytics/timeseries

GET /api/loft/analytics/topn

POST /api/loft/analytics/query

GET /api/loft/analytics/dashboards/

POST /api/loft/analytics/reports/schedule

POST /api/loft/analytics/reports/generate

GET /api/loft/analytics/export/csv

​GET /api/loft/analytics/timeseries

​GET /api/loft/analytics/topn

​POST /api/loft/analytics/query

​GET /api/loft/analytics/dashboards/

​POST /api/loft/analytics/reports/schedule

​POST /api/loft/analytics/reports/generate

​GET /api/loft/analytics/export/csv

GET /api/loft/analytics/timeseries

GET /api/loft/analytics/topn

POST /api/loft/analytics/query

GET /api/loft/analytics/dashboards/

POST /api/loft/analytics/reports/schedule

POST /api/loft/analytics/reports/generate

GET /api/loft/analytics/export/csv