dataset_version
dataset_version identifies what the API serves: the loaded data and the
code that turns it into responses. It is in every response envelope and is
the ETag value:
{"dataset_version": "e9c25a6", "data": {}}curl -D - -o /dev/null https://truefloat.app/api/v1/metaetag: "e9c25a6"Treat it as an opaque string: compare it for equality, never parse or order it.
What moves it, what doesn’t
Section titled “What moves it, what doesn’t”| change | dataset_version |
|---|---|
| a guide or item added, corrected or removed | changes |
| a fix to how responses are derived from the data (places, counts, aliases, response content) | changes |
| a docs, formatting or infrastructure deploy, this site included | unchanged |
An ETag stays valid across deploys that don’t change responses. See
Caching & conditional requests.
GET /v1/meta
Section titled “GET /v1/meta”The current version, when it was loaded, and counts:
curl https://truefloat.app/api/v1/meta{ "dataset_version": "e9c25a6", "data": { "dataset_version": "e9c25a6", "loaded_at": "2026-09-29T06:26:30.014749+00:00", "counts": { "items": 346, "guides": 351, "aliases": 1594, "systems": 744, "gradings": 94529 } }}counts.items counts (def_index, paint_index) pairs.