Sign in

v62

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-31136116265.6 KB
usage

Get route logs usage for a project with time range and period aggregation, when endDate is 0 or unspecified the current time is implied

get/v1/projects/{projectOrProductUID}/usage/route-logs

Path parameters

projectOrProductUIDstring required

Query parameters

startDateinteger

Start date for filtering results, specified as a Unix timestamp

endDateinteger

End date for filtering results, specified as a Unix timestamp

routeUIDstring[]

A Route UID.

limitinteger

Limit the number of data points returned

period'day' | 'week' | 'month' required

Period type for aggregation

aggregate'route' | 'project'

Aggregation level for results

skipRecentDataboolean

When true, skips fetching recent data from raw event tables and only returns data from summary tables. Use this for better performance on large projects.

Response

Response body for Route Log Usage

truncatedboolean

If the data is truncated that means that the parameters selected resulted in a response of over | the requested limit of data points, in order to ensure

Example response

{
  "route_logs": [
    {
      "avg_latency_ms": 342.5,
      "failed_routes": 4,
      "period": "2025-07-23T00:00:00Z",
      "route": "route:cbd20093cba58392c9f9bbdd0cdeb1a0",
      "successful_routes": 38,
      "total_routes": 42
    }
  ]
}