Guild module

This module manages:

• GET Get Guild (Name)
• GET Get Guild (Prefix)
• GET Guild list
• GET Guild territory list

It is located at https://api.wynncraft.com/v3/guild

Get Guild (Name)

GET .../ 10 minutes TTL

{
    "uuid": str,
    "name": str,
    "prefix": str,
    "level": int,
    "xpPercent": int,
    "territories": int,
    "wars": int,
    "created": str,
    "members": {
        "total": int,
        "owner": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            }
        },
        "chief": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "strategist": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "captain": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "recruiter": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "recruit": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "contributionRank": int,
                "joined": str,
            },
            # [...]
        }
    },
    "online": int,
    "banner": {
        "base": str,
        "tier": int,
        "structure": str,
        "layers": [
            {
                "colour": str,
                "pattern": str
            },
            # [...]
        ]
    },
    "seasonRanks": {
        "1": {
            "rating": int,
            "finalTerritories": int
        }
        # [...]
    }
}

Request Playground

TIP

You can use the query parameter identifier with either username or uuid as value to select how the members should be identified.

WARNING

Name queries are case-insensitive for easier usage but there is a possible edge-case where multiple guilds will match the said name, in that case a multi-selector will be returned with guild prefixes as the identifier and some guild stats as descriptive keys.

Get Guild (Prefix)

GET .../ 10 minutes TTL

{
    "uuid": str,
    "name": str,
    "prefix": str,
    "level": int,
    "xpPercent": int,
    "territories": int,
    "wars": int,
    "created": str,
    "members": {
        "total": int,
        "owner": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            }
        },
        "chief": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "strategist": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "captain": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "recruiter": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "guildRank": int,
                "joined": str,
            },
            # [...]
        },
        "recruit": {
            "<username/uuid>": {
                "<username/uuid>": str,
                "online": bool,
                "server": str or None,
                "contributed": int,
                "contributionRank": int,
                "joined": str,
            },
            # [...]
        }
    },
    "online": int,
    "banner": {
        "base": str,
        "tier": int,
        "structure": str,
        "layers": [
            {
                "colour": str,
                "pattern": str
            },
            # [...]
        ]
    },
    "seasonRanks": {
        "1": {
            "rating": int,
            "finalTerritories": int
        }
        # [...]
    }
}

Request Playground

TIP

You can use the query parameter identifier with either username or uuid as value to select how the members should be identified.

Guild List

GET .../ 1 hour TTL

# identifier = uuid
{
  "guildUuid": {
    "name": "name",
    "prefix": "prefix",
    # [...]
  },
  # [...]
}

# identifier = name
{
  "guildName": {
    "uuid": "uuid",
    "prefix": "prefix",
    # [...]
  },
  # [...]
}

Playground is disabled for this endpoint.

Guild Territory List

GET .../ 10 seconds TTL

{
    "territoryName": {
        "guild": {
            "uuid": str,
            "name": str,
            "prefix": str
        },
        "acquired": str,
        "location": {
            "start": [
                int,
                int
            ],
            "end": [
                int,
                int
            ]
        }
    },
    # [...]
}

Playground is disabled for this endpoint.