List items

get

https://api.tibia.dev/v1/items

Every object the wiki gives an article to, 9,800 of them, with what fits
on a row: the class and the categories it is filed under, its weight, the
prices NPCs trade it at, and whether it stacks or can go on the market.
Retired objects are in here too — filter[status]=active keeps to what
the game still hands out.

An item has one or two categories, and filter[category] matches either:
the wiki files the Machete as a Tool before it is a Sword Weapon, and
2,006 items sit in that position. Each category carries the slot it is
worn in, so filter[slot]=weapon is the same question asked of the
slots rather than the names.

Where an item comes from and what it is good for — what drops it, which
quests reward it, which imbuements it feeds, who buys and sells it — is
left out until you ask: name those relations in include, or read a
single item, which answers all of them at once.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter[name]

string

Rows whose name contains this text.

filter[status]

string

enum

Only rows whose status is one of these.

Allowed:

filter[client_id]

string

The id the game client uses for the sprite, and the only way to look a row up by it: the detail route takes the wiki article id instead, and the two are different numbers for the same thing — 3079 is the Parcel's article id and the Boots of Haste's client id. A few sprites are shared, so this can answer with more than one row.

filter[is_marketable]

boolean

enum

Only rows where marketable is true, or false for the rest.

Allowed:

filter[is_stackable]

boolean

enum

Only rows where stackable is true, or false for the rest.

Allowed:

filter[class]

string

enum

Items on a given shelf, named by slug or by name. Slugged first, as every vocabulary filter in the API is, so

filter[category]

string

enum

Items filed under a given category, named by slug or by name. Either of the item's two categories counts. Reading only the first would

filter[slot]

string

enum

Items with a category worn in a given slot. Either category counts, which is the same rule inCategory() uses and

filter[attribute]

string

enum

Items carrying a given attribute, optionally with a given value. Matched on the slug, which is what the filter publishes as its values —

filter[sold_in_store]

string

The 702 items the Store sells, or the 9,098 it does not. The one question the offers table answers about the catalogue as a whole:

filter[dropped_by]

string

Items a given creature drops, named by slug or by name. Both of the reverse filters slug their input first, the way route binding

filter[quest]

string

enum

Items a given quest hands out, named by slug or by name.

sort

string

enum

Column to sort by; prefix with - to reverse it. Defaults to name.

include

string

enum

Relations to embed in the response, comma separated.

page

integer

Which page to read.

per_page

integer

Rows per page, 25 by default and 100 at most. Anything that is not a positive whole number answers 400.

Response

200