API:1/events
From Guild Wars 2 Wiki
< API:1
Jump to navigationJump to search
/v1/events.json
- HTTP method
- GET
- Format
- json
- API version
- version 1
- Release date
- ?
- Scope
- none
- Optional
- none
This resource returns a list of events and their status that match the given filter.
Parameters
- Optional parameters
world_id
– Only list events for that world.map_id
– Only list events in that map.event_id
– Only list this event.
Response
The response is an object with the single property events
which contains list of event details, each of which contains the following properties:
world_id
(number) – The world on which the event is running.map_id
(number) – The map on which the event is running.event_id
(string) – The event GUID identifying the event.state
(string) – The current state of the event.
The state can be one of the following values:
Inactive
– The event is not running.Active
– The event is running now.Success
– The event has succeeded.Fail
– The event has failed.Warmup
– The event is inactive and waiting for certain criteria to be met before becomingActive
.Preparation
– The criteria for the event to start have been met, but certain activities (such as an NPC dialogue) have not completed yet. After the activites have been completed, the event will becomeActive
.
Example
https://api.guildwars2.com/v1/events.json?world_id=1001&map_id=39
{ "events": [ { "world_id": 1001, "map_id": 39, "event_id": "2875FBFE-668E-438A-8CE7-A4BCF2EF0175", "state": "Warmup" }, { "world_id": 1001, "map_id": 39, "event_id": "E0D7E88D-4FF6-42FA-AFFC-0DF4111C2CCD", "state": "Active" }, { "world_id": 1001, "map_id": 39, "event_id": "831DC6FB-5F63-4B0C-96A5-FE2037EBEE7F", "state": "Active" }, { "world_id": 1001, "map_id": 39, "event_id": "C6EFB827-EABC-4100-A6FE-97C7D9275CEC", "state": "Active" }, ... ] }