Player Quests API

Overview¶

This API allows you to retrieve the completion statuses for quests, subquests and miniquests relating to a specific player.

URL: https://secure.runescape.com/m=adventurers-log/api/v1/playerQuests/NAME - replace NAME with the display name of the player.

Example¶

{
    "quests": {
        "257": {
            "difficulty": 0,
            "eligible": true,
            "members": false,
            "title": "Cook's Assistant",
            "qp": 1,
            "status": "COMPLETED"
        },
        "289": {
            "difficulty": 3,
            "eligible": false,
            "members": true,
            "title": "Mourning's End Part I",
            "qp": 2,
            "status": "NOT_STARTED"
        },
        "307": {
            "difficulty": 2,
            "eligible": false,
            "members": true,
            "title": "Recipe for Disaster: Defeating the Culinaromancer",
            "qp": 1,
            "status": "STARTED"
        },
        // ...
    },
    "name": "Mod Example",
    "qp_max": 476,
    "qp": 235
}

Format¶

Errors will return an error response and an appropriate HTTP status code; see the Adventurer's Log Error Handling section for more details.

Top-level response¶

Field	Type	Description
`name`	String	Canonical display name for this player
`qp`	Integer	Amount of quest points attained by this player, calculated using the in-game logic
`qp_max`	Integer	Maximum amount of quest points that's currently possible to obtain
`quests`	Object	Map from internal quest IDs to quest objects

Quest object¶

Field	Type	Description
`title`	String	Name of the quest, subquest or miniquest
`difficulty`	Integer	Rated difficulty of the quest
`members`	Boolean	Whether this quest is restricted to RuneScape members
`qp`	Integer	How many quest points are awarded if this quest is complete
`eligible`	Boolean	Whether this player meets the requirements to do this quest
`status`	String	Either `NOT_STARTED`, `STARTED` or `COMPLETED` depending on this player's progress in the quest

Difficulty values¶

Value	Name
0	Novice
1	Intermediate
2	Experienced
3	Master
4	Grandmaster
250	Multi (currently not used)

Update delays¶

This data will synchronise to Adventurer's Log when a player logs out, hops worlds, and at semi-regular intervals during gameplay.

The Adventurer's Log caches responses, so newly synchronised data may not be returned by the API for up to 10 minutes.

Quest Point calculation¶

It might seem like you can calculate a player's quest points by summing the qp field for all quests that are marked with status: "COMPLETED", but this doesn't work in all cases.

There are a number of special situations, including (but not limited to):

Sheep Shearer was downgraded to a miniquest in 2010, but players who completed it before then kept their 1QP.
Myths of the White Lands normally awards 2QP, but if you have 1QP from shearing sheep, then the Myths reward is reduced to 1QP.
Dimension of Disaster can be replayed. Doing this resets the status to "STARTED", but you still keep the QP from your initial completion.

The qp field in the top-level response uses the Quest Points value calculated when the player last logged into the game, so it will mirror the special logic implemented there.