Skip to content

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/meta
etag: "e9c25a6"

Treat it as an opaque string: compare it for equality, never parse or order it.

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.

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.