QUERY API

Query service-scoped events programmatically.

Clients never read shared Parquet objects directly. The query API applies service identity, time bounds, suppression, and retention rules before returning event rows.

TrafficWar documentation · maintained by Mohammed Albadri

Authenticated request

Shell

curl "https://api.trafficwar.tech/query?from=2026-08-24T10:00:00Z&to=2026-08-24T11:00:00Z&limit=100" \
  -H "Authorization: Bearer $TRAFFICWAR_API_KEY"

Service scope is fixed by the key

A public query is pinned to the Bearer key’s service. The caller cannot expand that request to another service by adding query parameters.

Operational and client time

Time-range filtering uses received time because it drives partitions, retention, and metric windows. Responses also include client time when the original event supplied a valid timestamp.