v0.1.0 — first release
First release of the Trappers Home Assistant integration.
Reports a Trappers
(FiscFree) bike-to-work account's points balance and cycling activity as
seven Home Assistant sensors, one device per account.
| Sensor | Unit |
|---|---|
| Points balance | trappers |
| Points balance value | € |
| Cycling days total | — |
| Cycling days this month | — |
| Last cycling day | date |
| Points earned this month | trappers |
| Commute distance | km |
- Config flow with reauth; add the integration once per account.
- Polls every 30 minutes — a deliberately gentle default for an unofficial API.
- English and Dutch entity names, following your Home Assistant language.
- Only the numbers above are exposed. The API returns a great deal more about
the account holder; none of it is logged or surfaced.
Two behaviours worth knowing:
Cycling days are counted, not totalled. A collector unit sometimes reads the
same tag twice in a day; Trappers stores that as a duplicate entry that earns
no points. Both cycling-day sensors count distinct non-duplicate days, so they
match the points you were actually paid.
The euro value needs an order to exist. The points-to-euro rate is a term of
your employer's contract and the API only reveals it on an order record — so
"Points balance value" reads unknown until the account has placed its first
order, rather than showing an invented number.
Install: HACS → ⋮ → Custom repositories → this repo's URL, category
"Integration" → install → restart Home Assistant. Requires HA 2026.3.0+.
Unofficial and not affiliated with Trappers or FiscFree.