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.

// 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 + '" />'); }); }); })

// 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'] . '" />'; }

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

HabboAPI Documentation

Request a Badge

URL Parameters

Response Fields

Get a simple list of Badges