Houses

Documentation of how to use our v2 houses API.

TibiaData API v3 has been released and it’s not recommended to use v2 anymore.
Go to the documentation page to find a newer version.


Get houses of worlds

This API helps you to get a list of houses on a certain world, in a city and which type.

GET

GET

GET

This GET request requires the field world to be set in the URL.

This GET request has optional fields town and type to be set in the URL.

Default value of town is Ab’Dendriel.
You can use following fields instead: Ab’Dendriel, Ankrahmun, Carlin, Darashia, Edron, Farmine, Gray Beach, Kazordoon, Liberty Bay, Port Hope, Rathleton, Svargrond, Thais, Venore and Yalahar (or yeah, all the Tibia cities).

Default value of type is houses.
You can use following fields instead: houses and guildhalls.

Example URL:

https://api.tibiadata.com/v2/houses/Antica.json
https://api.tibiadata.com/v2/houses/Antica/Venore.json
https://api.tibiadata.com/v2/houses/Antica/Edron/guildhalls.json

Example JSON data:

{
  "houses": {
    "town": "Venore",
    "world": "Antica",
    "type": "houses",
    "houses": [
      {
        "houseid": 35006,
        "name": "Dagger Alley 1",
        "size": 57,
        "rent": 2665,
        "status": "rented"
      }, {
        "houseid": 35009,
        "name": "Dream Street 1 (Shop)",
        "size": 94,
        "rent": 4330,
        "status": "rented"
      },
      ...
    ]
  },
  "information": {
    "api_version": 2,
    "execution_time": 0.0011,
    "last_updated": "2017-12-15 08:00:00",
    "timestamp": "2017-12-15 08:00:02"
  }
}

One specific house of Tibia

This API helps you to get information of the house on in a city of Tibia.

GET

This GET request requires the field world and houseid to be set in the URL.

Example URL:

https://api.tibiadata.com/v2/house/Antica/40211.json

Example JSON data:

{
  "house": {
    "houseid": 40211,
    "world": "Antica",
    "name": "Great Willow 1a",
    "type": "house",
    "beds": 1,
    "size": 10,
    "rent": 500,
    "img": "https:\/\/dev.tibiadata.com\/statictibiacom\/houses_images_houses_house_40211.jpg",
    "status": {
      "occupied": true,
      "auction": false,
      "owner_now": "Serem Morindo",
      "owner_new": null,
      "current_bid": false,
      "auction_end": null,
      "paid_until": {
        "date": "2017-12-27 09:05:06.000000",
        "timezone_type": 2,
        "timezone": "CET"
      },
      "moving_date": null,
      "transfer_accept": false,
      "transfer_bid": null,
      "original": "The house has been rented by Serem Morindo. He has paid the rent until Dec 27 2017, 09:05:06 CET."
    }
  },
  "information": {
    "api_version": 2,
    "execution_time": 0.0016,
    "last_updated": "2017-12-15 08:00:00",
    "timestamp": "2017-12-15 08:00:02"
  }
}