Houses

Documentation of how to use our v2 houses API.

Get houses of worlds

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

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.

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"
  }
}