---
title: "GET /v1/projects/{projectOrProductUID}/usage/route-logs"
method: GET
path: "/v1/projects/{projectOrProductUID}/usage/route-logs"
tags: ["usage"]
---

# GET /v1/projects/{projectOrProductUID}/usage/route-logs

`GET /v1/projects/{projectOrProductUID}/usage/route-logs`

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

## Path parameters

- `projectOrProductUID` string, required

## Query parameters

- `startDate` integer
- `endDate` integer
- `routeUID` string[]
- `limit` integer
- `period` 'day' | 'week' | 'month', required
- `aggregate` 'route' | 'project'
- `skipRecentData` boolean

## Response `200`

Response body for Route Log Usage

- object
  - `route_logs` UsageRouteLogsData[], required
    - `avg_latency_ms` number, double, nullable — Average routing latency in milliseconds for route logs with recorded duration
    - `failed_routes` integer, required
    - `period` string, date-time, required
    - `route` string — The route UID (only present when aggregate is 'route')
    - `successful_routes` integer, required
    - `total_routes` integer, required
  - `truncated` boolean — 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

## Other responses

- `default` — The response body in case of an API error.

---

[API](https://skmtc.net/notefile/apis/notehub-api.md) · [All operations](https://skmtc.net/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notefile/notehub-api/revisions/9c5b2b63a991/schema)