Reports
Stored drive summaries per vehicle: one day, one week, or a day range. Needs the reports:read scope on API keys. Part of the documentation.
GET/v1/reports/daily
Returns one stored daily summary with its per-trip analyses attached: distance, driving and idle time, event counts, overspeed severity bands, and the cost proxy (cost: idle hours × €/h, harsh events × €/event, night km × €/km, plus the total — placeholder rates pending calibration). day is YYYY-MM-DD in fleet-local time (Europe/Athens). A day that was never computed reads 404 — summaries compute nightly, or on demand from the dashboard Reports page.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/daily?device_id=43&day=2026-10-04' \
-H "Authorization: Bearer [REDACTED]…"| Parameter | Required | Notes |
|---|---|---|
device_id | Yes | Traccar device id from GET /devices. Another org's id reads 404. |
day | Yes | YYYY-MM-DD, Europe/Athens. Malformed dates read 422. |
idle_eur_per_hour | No | Custom idle rate for cost; defaults to the server setting. Negative rates read 422. |
harsh_eur_per_event | No | Custom harsh-event rate for cost; defaults to the server setting. |
night_eur_per_km | No | Custom night-km rate for cost; defaults to the server setting. |
GET/v1/reports/weekly
Returns one fleet-local Mon–Sun rollup: week totals plus all seven day slots (a day with no computed summary is flagged, never zero-filled), a narrative, the week's safety score computed live, and the cost proxy over the week totals (same cost shape as daily). week is any date inside the week — it snaps to Monday.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/weekly?device_id=43&week=2026-10-04' \
-H "Authorization: Bearer [REDACTED]…"| Parameter | Required | Notes |
|---|---|---|
device_id | Yes | Traccar device id from GET /devices. |
week | Yes | Any YYYY-MM-DD inside the week, Europe/Athens. |
idle_eur_per_hour | No | Custom idle rate for cost; defaults to the server setting. Negative rates read 422. |
harsh_eur_per_event | No | Custom harsh-event rate for cost; defaults to the server setting. |
night_eur_per_km | No | Custom night-km rate for cost; defaults to the server setting. |
GET/v1/reports/history
Lists the last N stored daily summaries, oldest first without per-trip rows — the input for trend charts. Days without a computed summary are absent.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/history?device_id=43&days=30' \
-H "Authorization: Bearer [REDACTED]…"| Parameter | Required | Notes |
|---|---|---|
device_id | Yes | Traccar device id from GET /devices. |
days | No | Window length; default 30, max 90. |