API:2/professions
From Guild Wars 2 Wiki
< API:2
Jump to navigationJump to search
/v2/professions
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2016-03-09
- Scope
- none
- Optional
- none
This resource returns information about professions that are in the game.
Endpoints
- None - Request the list of all available profession
idswhen the root endpoint (v2/professions) has been accessed. id- (Optional) Request the profession for the specificedidwhen accessing the endpoint (v2/professions/id). Cannot be used when specifying theidsparameter.
Parameters
lang– (Optional) Request localized information.page- (Optional; integer)page_size- (Optional; integer)ids- (Optional; Comma Delimited List|all) Request an array of professions for the specifiedidsor all professions. Cannot be used when using theidendpoint.
Response
For each requested profession id, an object with the following properties is returned:
id(string) (default/null value: "") - The profession id.name(string) (default/null value: "") - The name of the profession.code(number) - The profession code for a build template link. Available on schema version2019-12-19T00:00:00.000Zor later.icon(string) (default/null value: "") - The icon for the profession.icon_big(string) (default/null value: "") - The large icon for the profession.specializations(array of integer) (default/null value: 0) - List of API:2/specializationsids.training(array of objects) (default/null value: {} empty array) - List of training details objects.id(integer) (default/null value: 0) - Theidof the API:2/skills or API:2/specializations inidcated by thecategory.category(string) (default/null value: "") - Thecategoryfor the training object. May include the following values:Skills- API:2/skills.Specializations- API:2/specializations.EliteSpecializations- Elite Specializations API:2/specializations.
name(string) (default/null value: "") - Thenameof the skill or specialization inidcated by thecategoryandid.track(array of objects) (default/null value: {} empty array) - List of skills and traits training details tracks objects. Includes the following objects:cost(integer) (default/null value: 0) - The cost to train this skill or trait.type(string) (default/null value: "") - Inidcates whether this is a skill or trait. May include the following values:TraitSkill
skill_id(integer) (default/null value: 0) - The API:2/skillsid. This field is only present iftypeisSkill.trait_id(integer) (default/null value: 0) - The API:2/traitsid. This field is only present iftypeisTrait.
weapons(object) - The weapons available for this profession. The key indicates the weapon type, which is one of the following:Axe- AxeDagger- DaggerMace- MacePistol- PistolSword- SwordScepter- ScepterFocus- FocusShield- ShieldTorch- TorchWarhorn- WarhornGreatsword- GreatswordHammer- HammerLongbow- LongbowRifle- RifleShortbow- Short bowStaff- StaffSpeargun- SpeargunSpear- SpearTrident- Trident
flags(array of strings) - Can contain the following values:NoRacialSkills- This profession cannot equip racial skills.NoWeaponSwap- This profession can only use one weapon set.
skills_by_palette(array of arrays of two numbers) - Contains arrays of two numbers. The first number is a skill palette ID obtained from a build template link, the second number is a skill ID. This is so you can resolve palette IDs obtained from a build template link to API:2/skills. This is only available on schema version2019-12-19T00:00:00.000Z
Each of the above weapons objects contain the following properties:
flag(array of string) - May be one of:"Mainhand","Offhand","TwoHand","Aquatic".specialization(integer) (default/null value: 0) - The API:2/specializationsidof the required specialization to use this weapon. This field is only present if the weapon requires a specialization to be used.skills(array of objects) (default/null value: {} empty array) - The list of weapon skills objects. Includes the following objects:id(integer) (default/null value: 0) - Theidof the API:2/skills.slot(string) (default/null value: "") - The skill bar slot that this weapon skill can be used in. May include the following values:Profession_1UtilityHealElite
offhand(string) (default/null value: "") - The name of the offhand weapon this skill requires to be equipped. This field is usually only present for Thief skills.attunement(string) (default/null value: "") - The Elementalist attunement that this skill requires. This field is usually only present for Elementalist skills.source(string) (default/null value: "") - The name of the class the skill was stolen from. This only applies to thief stolen skills.
Example
https://api.guildwars2.com/v2/professions
[ "Guardian", "Warrior", "Engineer", "Ranger", "Thief", "Elementalist", "Mesmer", "Necromancer", "Revenant" ]
https://api.guildwars2.com/v2/professions/Engineer
{
"id":"Engineer",
"name":"Engineer",
"icon":"https://render.guildwars2.com/file/5CCB361F44CCC7256132405D31E3A24DACCF440A/156632.png",
"icon_big":"https://render.guildwars2.com/file/A94D00911BD47CDE39A104F90C7D07DE623554ED/156631.png",
"specializations":[
6,
38,
47,
29,
21,
43
],
"weapons":{
"Hammer":{
"specialization":43,
"skills":[
{
"id":30501,
"slot":"Weapon_1"
},{
"id":30088,
"slot":"Weapon_2"
}]
},
"Pistol":{
"skills":[
{
"id":5827,
"slot":"Weapon_1"
}]
}
},
"training":[
{
"id":21,
"category":"Skills",
"name":"Elixir Training",
"track":[
{
"cost":2,
"type":"Skill",
"skill_id":5821
},{
"cost":5,
"type":"Skill",
"skill_id":5860
}
]
}
"flags": ["NoWeaponSwap"],
"skills": [
{
"id": 5834,
"slot": "Heal",
"type": "Heal"
},
...
{
"id": 5818,
"slot": "Utility",
"type": "Utility"
},
...
{
"id": 30800,
"slot": "Elite",
"type": "Elite"
},
...
]
}
https://api.guildwars2.com/v2/professions?ids=Necromancer
[
{
"id":"Necromancer",
"name":"Necromancer",
...,
}
]
https://api.guildwars2.com/v2/professions?ids=Necromancer,Warrior
[
{
"id":"Necromancer",
"name":"Necromancer",
...,
},{
"id":"Warrior",
"name":"Warrior",
...,
}
]
API bug:
