Skip to content
TrueFloat API

Empty vs missing

request answer
unknown def_index, or a paint_index the item doesn’t have 404 not_found
known item, seed no guide grades 200, verdicts: [], every covering system listed in not_listed
known item with no guide at all 200, guides: [] or seeds: {}
unknown steam_id or system 404 not_found

The rule: missing identity is 404; missing opinion is 200 with an empty list. An item that exists always answers 200, even with zero guides. A seed that exists on a real item, but that no guide happens to grade, still answers 200 — with an empty verdicts array and the list of systems that could have graded it in not_listed, so a caller can tell “not ranked by this guide” apart from “this guide doesn’t exist.”

Terminal window
curl https://truefloat.app/api/v1/items/7/44/seeds/1
{
  "dataset_version": "e9c25a6",
  "data": {
    "item": {
      "def_index": 7,
      "paint_index": 44,
      "slug": "ak47-case-hardened"
    },
    "seed": 1,
    "verdicts": [],
    "not_listed": [
      {"steam_id": "2941982575", "system": "ak47-blue-gem"},
      {"steam_id": "3313951742", "system": "ak47-gold-gem"}
    ]
  }
}
Terminal window
curl https://truefloat.app/api/v1/items/7/45
{
  "dataset_version": "e9c25a6",
  "error": {"code": "not_found", "message": "no item def 7 paint 45"}
}