API:2/quests

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/quests

HTTP method
GET
Format
json
API version
version 2
Release date
2019-06-13
Scope
none
Optional
none

This resource returns information about Story Journal missions within the personal story and Living World.

Endpoints

  • None - Request the list of all available quest ids when the root endpoint (v2/quests) has been accessed.
  • id - (Optional) Request the quest for the specified id when accessing the endpoint (v2/quests/id). Cannot be used when specifying the id or ids parameters.

Parameters

  • lang – (Optional) Request localized information.
  • page - (Optional; integer)
  • page_size - (Optional; integer)
  • id - (Optional) Request the quest for the specified id. Cannot be used when specifying the id endpoint or ids parameter.
  • ids - (Optional; Comma Delimited List|all) Request an array of quests for the specified ids or all quests. Cannot be used when using the id endpoint or id parameter.

Response

For each requested quest id, an object with the following properties is returned:

  • id (integer) - The id of the quest.
  • name (string) - The name of the quest.
  • level (integer) - The minimum level required for a character to begin this quest.
  • story (integer) - The id for the story; resolvable against v2/stories.
  • goals (array of objects) - An array of goal objects providing details about the goals for this quest. Each object may contain the following values:
    • active (string) - The text displayed for the quest step if it is active.
    • complete (string) - The text displayed for the quest step if it is complete.

Note

  • This endpoint (lowest level) is whitelisted manually and does not update as fast as the associated API:2/stories (middle level) and API:2/stories/seasons (top level) endpoints.

Example

https://api.guildwars2.com/v2/quests

[
  15,
  16,
  17,
  18,
  ...
]

https://api.guildwars2.com/v2/quests/19

{
  "name": "Defusing the Problem",
  "level": 10,
  "story": 8,
  "goals": [
    {
      "active": "Extract Doxa from the MIG.",
      "complete": "Despite the Inquest's continued interference, we managed to extract Doxa from the MIG. We also took care of that skunk Teyo once and for all. Kazz and Doxa took a much-needed break from the action, and I was awarded the title \"Snaff Savant\" by the rest of the krewe. I think I also impressed Zojja, as she promised to keep an eye on me and my progress from here on. All in all, not a bad day."
    },
    {
      "active": "See if there's any more trouble brewing in Metrica Province.",
      "complete": ""
    }
  ],
  "id": 19
}

https://api.guildwars2.com/v2/quests?ids=20

[
  {
    "name": "The Things We Do For Love",
    "level": 10,
    "story": 8,
    "goals": [
      {
        "active": "Fuse Kazz with a golem so he and Doxa can be together.",
        "complete": "Despite the Inquest's continued interference, we successfully fused Kazz with a golem so that he and Doxa could be together forever. Once they were safe, Hronk offered me the title of Snaff Savant. I took it, of course: who else is more deserving? I think I also impressed Zojja, as she promised to keep an eye on me and my progress from here on."
      },
      {
        "active": "See if there's any more trouble brewing in Metrica Province.",
        "complete": ""
      }
    ],
    "id": 20
  }
]