Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[GET] /community/clan/getClanInfoFull

Example request

Returns full details for a clan including its permissions and member list with player avatars.

Request

parametertypevaluecomments
titlestr/enumage1, age2, age3, age4Game title
namestrgliClan tag

Response

AoE2:DE

Returns the clan object with nested permissions (one entry per role rank) and members (one entry per clan member). The members array below is trimmed to 1 entry.

{
    "result": {
        "code": 0,
        "message": "SUCCESS"
    },
    "clan": {
        "id": 52618,
        "name": "gli",
        "fullname": "TheClick",
        "description": "",
        "tags": "",
        "icon": "CR-001",
        "membercount": 4,
        "joinpolicy": 0,
        "metadata": "",
        "messageoftheday": "",
        "statgroup_id": 2254028,
        "permissions": [
            {
                "rank": 1,
                "chat": 1,
                "promote": 1,
                "demote": 1,
                "invite": 1,
                "remove": 1,
                "disband": 1,
                "editinfo": 1,
                "editpermission": 1,
                "name": "Leader",
                "locstringid": -1
            },
            {
                "rank": 2,
                "chat": 1,
                "promote": 1,
                "demote": 1,
                "invite": 1,
                "remove": 1,
                "disband": 0,
                "editinfo": 0,
                "editpermission": 0,
                "name": "Officer",
                "locstringid": -1
            },
            {
                "rank": 3,
                "chat": 1,
                "promote": 0,
                "demote": 0,
                "invite": 0,
                "remove": 0,
                "disband": 0,
                "editinfo": 0,
                "editpermission": 0,
                "name": "Member",
                "locstringid": -1
            }
        ],
        "members": [
            {
                "avatar": {
                    "entityversion": 7676,
                    "profile_id": 2327018,
                    "name": "/steam/76561198300477799",
                    "metadata": "{\"icon\":\"PR7-031\"}",
                    "alias": "Atashwong",
                    "clanlist_name": "gli",
                    "personal_statgroup_id": 2072253,
                    "xp": 276,
                    "level": 1,
                    "leaderboardregion_id": 3,
                    "presence_id": 0,
                    "presenceproperty": []
                },
                "membershipstatus": 1,
                "playerlistpermission_rank": 1
            }
        ]
    }
}

Clan fields

fieldtypedescription
idintUnique clan identifier
namestringShort clan tag
fullnamestringFull display name of the clan
descriptionstringClan description text
tagsstringComma-separated tags
iconstringClan icon identifier (e.g. "CR-001")
membercountintCurrent number of members
joinpolicyintJoin policy (0 = open, 1 = invite/request only)
metadatastringAdditional metadata (JSON string)
messageofthedaystringClan message of the day
statgroup_idintAssociated stat group identifier

Permission fields

fieldtypedescription
rankintRole rank (1 = Leader, 2 = Officer, 3 = Member)
chatintCan send chat messages (0/1)
promoteintCan promote members (0/1)
demoteintCan demote members (0/1)
inviteintCan invite players (0/1)
removeintCan remove members (0/1)
disbandintCan disband the clan (0/1)
editinfointCan edit clan info (0/1)
editpermissionintCan edit role permissions (0/1)
namestringDisplay name of the role
locstringidintLocalization string ID (-1 if custom)

Member fields

fieldtypedescription
membershipstatusintMembership status (1 = active)
playerlistpermission_rankintPermission rank of this member

Avatar fields (nested in each member)

fieldtypedescription
entityversionintVersion counter for the entity
profile_idintUnique player profile identifier
namestringPlatform identifier (e.g. /steam/<id>)
metadatastringJSON string with profile metadata
aliasstringPlayer display name
clanlist_namestringClan tag the player belongs to
personal_statgroup_idintPlayer’s personal stat group identifier
xpintExperience points
levelintPlayer level
leaderboardregion_idintLeaderboard region identifier
presence_idintOnline presence status
presencepropertyarrayAdditional presence properties