List NPCs

get

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

1,245 characters, each with the jobs and races the wiki files them under,
the city they belong to and the square they stand on. coordinates is
null for the handful with no fixed spot. What they trade and where they
will take you are opt-in: include=offers and include=destinations.

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[gender]

string

enum

Only rows whose gender is one of these.

Allowed:

filter[city]

string

enum

Narrows the list by city.

filter[job]

string

enum

Narrows the list by job.

filter[race]

string

enum

Narrows the list by race.

filter[sells]

string

NPCs a player can buy the item from.

filter[buys]

string

NPCs a player can sell the item to.

sort

string

enum

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

Allowed:

include

string

enum

Relations to embed in the response, comma separated.

Allowed:

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

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200