HabboAPI Documentation

Join us on Twitter
Menu
Star

Request a Badge

If you want to make a list of the latest badges added to Habbo, or a tool that displays badges with most owners, you will need to make a Badge Request. The following documentation shows you have to do that, wich URL Parameters you can use and wich Response Fields you will get back.


Note that all badges added after 28-04-2017, will not have descriptions. Habbo has stopped useing Badge and Furni descriptions, on all hotels.


We have devided the different hotels up, so you are able to make lists of badges for each country or languages.

URL Parameters


The following table shows request parameters you can use in a badge API call.


Name Type Required Details
name

String

No

Wildcard search for badges with that name.
description

String

No

Wildcard search for badges with that description.
code

String

No

Wildcard search for badges with that code.
hotel

String

No

Wildcard search for badges for specific hotel only.
new

String

No

If supplied, will only return new badges.
has_image

String

No

If supplied, will show all badges, also those without image.
achievement

String

No

Wildcard search for achievement badges.
per_page

Integer
(Default: 50/400)

No

Paginates the result by value provided.

Response Fields


The following table shows response fields returned by the badge API call.


Name Type Details
name

String

Return badge name.
description

String

Return badge description.
code

String

Return unik badge code.
hotel

String

Return specific hotel where the badge are used. Eg. com.
badge_owners

String

Return total amount of Habbos who own the badge.
new

Boolean

Return true or false, if the badge is less then 24 hours old.
has_image

Boolean

Return true or false if badge has image.
image

String

Return full URL to badge image.
achievement

Boolean

Return true or false if achievement badge.
discovered_at

String

Return date and time on the day we discovered it.
discovered_at_iso

String

Return iso timestamp on the day we discovered it.
total

String

Return total amount of badges.
per_page

String

Return badges shown per page.
prev_page_url

String

Return full url to previous badge page.
next_page_url

String

Return full url to next badge page.

We hope to bring much more features to the API, in the future.

Get a simple list of Badges

  • jQuery
  • PHP
// Make sure you include the official jQuery Library
// This is a simple example and return a list of 50 badges
$(function(){

	// Get Badges from our API
	$.getJSON('https://api.habboapi.net/badges?per_page=50', function(badges){
		$.each(badges.data, function(key, badge){
			// Append badges to div
			$('#badges').append('<img src="' + badge.image + '" />');	
		});
	});
})
// JavaScript
// This is a simple example and will only give you a list of badges
$api_url = 'https://api.habboapi.net/badges?per_page=50';

// Get Badges from our API
$badges = json_decode(file_get_contents($api_url), true); 
foreach($badges['data'] as $badge){
	// Echo out badges
	echo '<img src="' . $badge['image'] . '" />'; 
}
Json API response example
{
	"current_page":1,
	"data":[
		{
			"code":"TRE30",
			"name":"Habboloji.com / Şu Surata Bir Gülümseme Yerleştirelim",
			"description":"",
			"hotel":"com.tr",
			"discovered_at_iso":"2019-10-25T13:37:10+00:00",
			"discovered_at":"2019-10-25 13:37:10",
			"image":"https://habboo-a.akamaihd.net/c_images/album1584/TRE30.gif",
			"achievement":false,
			"new":true,
			"has_image":true,
			"badge_owners":0,
		}
	],
	"from":1,
	"last_page":58604,
	"next_page_url":"https://api.habboapi.net/badges?page=2",
	"path":"https://api.habboapi.net/badges",
	"per_page":"50",
	"prev_page_url":null,
	"to":1,
	"total":58604,
}
HTML Result Example
Warning: file_get_contents(https://api.habboapi.net/badges?per_page=50): failed to open stream: Connection timed out in /customers/1/a/a/habboapi.net/httpd.www/docs/badges/request.php on line 408 Warning: Invalid argument supplied for foreach() in /customers/1/a/a/habboapi.net/httpd.www/docs/badges/request.php on line 409