Skip to content
GET /v1/friends

A player's public friends list

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/habbo-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/habbo-api/v1/friends" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/habbo-api/v1/friends", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/habbo-api/v1/friends");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/habbo-api/v1/friends",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "name": "Frank",
        "source": "Habbo",
        "friends": [
            {
                "name": "!!@@Spidi@@!!",
                "motto": "<SS> Gaurdian <A26>",
                "figure": "hr-802-44.hd-190-1.ch-235-72.lg-3078-76.sh-3115-73-72.wa-2008",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-802-44.hd-190-1.ch-235-72.lg-3078-76.sh-3115-73-72.wa-2008&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": "!=.Frank.=!",
                "motto": "NE MUTLU TÜRKÜM DİYENE",
                "figure": "hr-830-45.hd-209-10.ch-3030-1408.lg-3023-85.sh-906-85.ha-1023-73.fa-1206-91.cc-3294-85-1408",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-830-45.hd-209-10.ch-3030-1408.lg-3023-85.sh-906-85.ha-1023-73.fa-1206-91.cc-3294-85-1408&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": ",.:FaitH:.,",
                "motto": "|dnb|",
                "figure": "hr-100.hd-180-1.ch-210-66.lg-270-82.sh-290-80",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-100.hd-180-1.ch-210-66.lg-270-82.sh-290-80&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": ",Frank.",
                "motto": "Just do it.",
                "figure": "hr-155-40.hd-180-1370.ch-808-1408.lg-285-64.sh-290-64.fa-1205-64",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-155-40.hd-180-1370.ch-808-1408.lg-285-64.sh-290-64.fa-1205-64&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": ",vintagePANTS?",
                "motto": "Haha never!",
                "figure": "hr-515-39.hd-605-14.ch-660-73.lg-710-1408.he-1601.ea-1401-1408",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-515-39.hd-605-14.ch-660-73.lg-710-1408.he-1601.ea-1401-1408&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": "-2i",
                "motto": "#NotMyHabbo",
                "figure": "hr-125-45.hd-180-8.ch-215-1408.lg-280-76.sh-290-1408.ha-1003-76.fa-3276-91",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-45.hd-180-8.ch-215-1408.lg-280-76.sh-290-1408.ha-1003-76.fa-3276-91&size=l&headonly=1&direction=2&head_direction=3"
            },
            {
                "name": "-_Rose_-",
                "motto": "|",
                "figure": "hr-890-39.hd-629-1.ch-655-73.lg-3088-1408-64.ha-3117-64.ea-3484.fa-3276-72",
                "online": false,
                "headshot": "https://www.habbo.com/habbo-imaging/avata
…