API:2/guild/:id

From Guild Wars 2 Wiki
< API:2‎ | guild
Jump to navigationJump to search

/v2/guild/:id

HTTP method
GET
Format
json
API version
version 2
Release date
2016-07-26
Scope
none
Optional
guilds

This resource returns core details about a given guild. The end point will include more or less fields dependend on whether or not an API Key of a Leader or Member of the Guild with the guilds scope is included in the Request.

Response

The endpoint must be requested with :id replaced with a valid guild ID. The endpoint will return an array of objects, each describing a guild detail.

Available fields without a leader or member token
  • id (string) - The unique guild id.
  • name (string) - The guild's name.
  • tag (string) - The 2 to 4 letter guild tag representing the guild.
  • emblem (object) - The guild emblem (see below). Possible values:
    • background (object) - An array containing information of the background of the guild emblem.
      • id (number) - The background id, to be resolved against /v2/emblem/backgrounds
      • colors (array of numbers) - An array of numbers containing the id of each color used.
    • foreground (object) - An array containing information of the foreground of the guild emblem.
      • id (number) - The background id, to be resolved against /v2/emblem/foregrounds
      • colors (array of numbers) - An array of numbers containing the id of each color used.
    • flags (array of strings) - An array containing the manipulations applied to the logo. Possible values:
      • FlipBackgroundHorizontal (string)
      • FlipBackgroundVertical (string)
Additional available fields with a leader or member token
  • level (number) - The current level of the guild.
  • motd (string) - The message of the day written out in a single string.
  • influence (number) - The guild's current influence.
  • aetherium (string) - The guild's current aetherium level.
  • favor (number) - The guild's current level of favor.
  • resonance (number) - The guild's current amount of resonance.
  • member_count (number) - The number of People currently in the Guild.
  • member_capacity (number) - The maximum number of People that can be in the Guild. (see Guild#Membership)

Example

https://api.guildwars2.com/v2/guild/116E0C0E-0035-44A9-BB22-4AE3E23127E5
{
  "level":34,
  "motd":"Our unique message of the day",
  "influence":52800,
  "aetherium":15000,
  "resonance":1121,
  "favor":680,
  "id":"116E0C0E-0035-44A9-BB22-4AE3E23127E5",
  "name":"Edit Conflict",
  "tag":"wiki",
  "emblem":{
    "background":
      {
        "id":8,
        "colors":[64]
      },
    "foreground":
      {
        "id":18,
        "colors":[584,146]
      },
    "flags":
      [
        "FlipBackgroundHorizontal"
      ]
    }
 }