---
title: "Get statistics"
method: GET
path: "/api/statistics/usage"
tags: ["statistics"]
---

# Get statistics

`GET /api/statistics/usage`

Returns the statistics file that will be shared with the development team if sharing statistics is enabled. A cached file is returned unless it is more than 2 hours old or `?force=1` is passed, in which case it is regenerated.

## Query parameters

- `force` integer

## Response `200`

Usage statistics payload

- object

## Changes

- **2026-05-13** `8c7f07770434` — 1 info
  - added the new optional `query` request parameter `force`
- **2026-05-13** `34a577bdabff` — 1 warning
  - deleted the `query` request parameter `force`

[Change history](https://skmtc.dev/falconchristmas/apis/fpp-api/changes/api/statistics/usage/get.md)

---

[API](https://skmtc.dev/falconchristmas/apis/fpp-api.md) · [All operations](https://skmtc.dev/falconchristmas/apis/fpp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/falconchristmas/fpp-api/revisions/7fea87547dc9/schema)