Skip to content

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

Missing identity is a 404; missing opinion is a 200 with an empty list. not_listed names the systems that cover the item but don’t grade the seed, so “not ranked by this guide” is distinct from “no such guide”.

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"}
]
}
}
curl https://truefloat.app/api/v1/items/7/45
{
"dataset_version": "e9c25a6",
"error": {"code": "not_found", "message": "no item def 7 paint 45"}
}