API:2/pvp/seasons
From Guild Wars 2 Wiki
/v2/pvp/seasons
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2015-09-03
- Scope
- none
- Optional
- none
This resource returns information about League seasons.
Parameters
-
lang
- (optional) Request localized information.
Response
If the root endpoint (/v2/pvp/seasons
) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids
parameter, a list of response objects is returned.
For each requested season id, an object with the following properties is returned:
-
id
(string) - The season's UUID. -
name
(number) - The season's name. -
start
(string) - ISO timestamp for season start. -
end
(string) - ISO timestamp for season end. -
active
(boolean) - Whether or not the season is currently active. -
divisions
(array of objects) - a list of divisions.-
name
(string) - The division's name. -
flags
(array of strings) - Flags applying to the division.-
CanLosePoints
-
CanLoseTiers
-
Repeatable
-
-
large_icon
(string) - Path to the large icon. -
small_icon
(string) - Path to the small icon. -
pip_icon
(string) - Path to the pip icon. -
tiers
(array of objects) - a list of tiers.-
points
(number) - The number of pipes contained in each tier
-
-
-
leaderboards
(array of objects) - Contains details on the current leaderboards-
ladder
-
settings
-
name
(string) - Seems to always be an empty string -
duration
(number) - Seems to always benull
-
scoring
(string) - Indicates the primary scoring component.[verification requested] -
tiers
(array of objects)-
range
(array of numbers) - Two numbers, a maximum, followed by minimum.[verification requested]
-
-
-
scorings
(array of objects) - Array used as reference to select player/guild scoring methodid
(string) - The id for this scoring method, used as a reference in other endpoints.type
(string) - Will which variable type the content is saved as.description
(string) - Description of the scoring method (if any).name
(string) - Should represent the scoring method, such as "wins", "losses", and "skill rating".ordering
(string) - Will describe how the scoring is ordered.
-
-
Example
Request
https://api.guildwars2.com/v2/pvp/seasons?id=44B85826-B5ED-4890-8C77-82DDF9F2CF2B https://api.guildwars2.com/v2/pvp/seasons/44B85826-B5ED-4890-8C77-82DDF9F2CF2B
Response
{ "id": "A54849B7-7DBD-4958-91EF-72E18CD659BA", "name": "PvP League Season Five", "start": "2016-12-13T20:00:00.000Z", "end": "2017-02-07T00:00:00.000Z", "active": true, "divisions": [ { "name": "Cerulean", "flags": [ ], "pip_icon": "https://render.guildwars2.com/file/DF4AE7C6B85711B5EF0A970851672FFE230FE61D/1614836.png", "tiers": [ { "points": 20 }, { "points": 20 }, { "points": 20 } ] }, ... { "name": "Byzantium (Repeatable)", "flags": [ "Repeatable" ], "pip_icon": "https://render.guildwars2.com/file/32A2E3C56EE514912A0AF41C9904AFAF64082D0B/1614841.png", "tiers": [ { "points": 30 }, ... { "points": 30 } ] } ], "leaderboards": { "ladder": { "settings": { "name": "", "duration": null, "scoring": "0F86D504-63C2-4465-80AA-C278E1CB7800", "tiers": [ { "range": [ 1, 1 ] }, ... { "range": [ 250, 101 ] } ] }, "scorings": [ { "id": "0F86D504-63C2-4465-80AA-C278E1CB7800", "type": "Integer", "description": "Effective rating that includes decay.", "name": "Rating", "ordering": "MoreIsBetter" }, { "id": "8A5F1199-CFD8-44CE-84C3-811C5EE8B16C", "type": "Integer", "description": "", "name": "Wins", "ordering": "MoreIsBetter" }, { "id": "FECEE3A5-B66C-44A3-B81E-65EA43829E1D", "type": "Integer", "description": "", "name": "Losses", "ordering": "LessIsBetter" } ] } } }