PHPackages                             gw2treasures/gw2api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. gw2treasures/gw2api

ActiveLibrary[API Development](/categories/api)

gw2treasures/gw2api
===================

PHP wrapper for the Guild Wars 2 API.

4.0.2(2y ago)2391210[5 issues](https://github.com/GW2Treasures/gw2api/issues)[1 PRs](https://github.com/GW2Treasures/gw2api/pulls)MITPHPPHP &gt;=7.2.5

Since Mar 14Pushed 1y ago4 watchersCompare

[ Source](https://github.com/GW2Treasures/gw2api)[ Packagist](https://packagist.org/packages/gw2treasures/gw2api)[ Docs](https://github.com/GW2Treasures/gw2api)[ RSS](/packages/gw2treasures-gw2api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (46)Used By (0)

gw2treasures/gw2api
===================

[](#gw2treasuresgw2api)

[![version](https://camo.githubusercontent.com/aa5751c10f866f985cac424a8038bcf628a6ed0bbd06e77f2d5d99e8098d2605/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6777327472656173757265732f6777326170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gw2treasures/gw2api)[![license](https://camo.githubusercontent.com/22eea07a5ac0c7d9c9f384e9806ce7b50a2b1305bc8f254c2a50e5c4dbf1411a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6777327472656173757265732f6777326170692e7376673f7374796c653d666c61742d737175617265)](./LICENSE)

**PHP wrapper for the Guild Wars 2 API**.

Features
--------

[](#features)

- Support for all v2 endpoints (including authenticated)
- Parallel requests for pagination and bulk expansion

Requirements
------------

[](#requirements)

- PHP &gt;= 7.2

Setup
-----

[](#setup)

### Using [composer](https://getcomposer.org) (recommended)

[](#using-composer-recommended)

```
composer require gw2treasures/gw2api
```

If you haven't included composers autoloader yet, you will have to add this before being able to use the GW2 API Wrapper.

```
include 'vendor/autoload.php';
```

### Using the gw2api.phar archive

[](#using-the-gw2apiphar-archive)

You need to download the [latest gw2api.phar](https://github.com/GW2Treasures/gw2api/releases/latest)and the [guzzle.phar of the latest 7.x version](https://github.com/guzzle/guzzle/releases/latest) of the [guzzle](https://github.com/guzzle/guzzle) library and place both files in your project directory. Now you can include both files to start using the GW2 API wrapper.

```
include __DIR__ . '/gw2api.phar';
include __DIR__ . '/guzzle.phar';
```

Examples
--------

[](#examples)

```
// create new api instance
$api = new \GW2Treasures\GW2Api\GW2Api();

// get all worlds
$worlds = $api->worlds()->all();

// get some happy quaggans
$quaggans = $api->quaggans()->many([ 'cheer', 'party' ]);

// get item details in german
$ektoplasmakugel = $api->items()->lang('de')->get(19721);

// search recipes
$recipes = $api->recipes()->search()->input(46746);

// get all character names
$characters = $api->characters('api_key')->ids();

// get 10 recently bought items
$recentlyBought = $api->commerce()->transactions('api_key')->history()->buys()->page(0, 10);
```

Usage
-----

[](#usage)

For all examples it is assumed that you have a variable `$api = new GW2Api()`.

### Endpoint Overview

[](#endpoint-overview)

API EndpointClass†
InstanceFlags‡/v2/account[Account\\AccountEndpoint](#v2account)
`GW2Api::account()`🔒/v2/account/achievements[Account\\AchievementEndpoint](#v2accountachievements)
`GW2Api::account()->achievement()`🔒/v2/account/bank[Account\\BankEndpoint](#v2accountbank)
`GW2Api::account()->bank()`🔒/v2/account/dyes[Account\\DyeEndpoint](#v2accountdyes)
`GW2Api::account()->dyes()`🔒/v2/account/finishers[Account\\FinisherEndpoint](#v2accountfinishers)
`GW2Api::account()->finishers()`🔒/v2/account/inventory[Account\\InventoryEndpoint](#v2accountinventory)
`GW2Api::account()->inventory()`🔒/v2/account/masteries[Account\\MasteryEndpoint](#v2accountmasteries)
`GW2Api::account()->masteries()`🔒/v2/account/materials[Account\\MaterialEndpoint](#v2accountmaterials)
`GW2Api::account()->materials()`🔒/v2/account/minis[Account\\MiniEndpoint](#v2accountminis)
`GW2Api::account()->minis()`🔒/v2/account/recipes[Account\\RecipeEndpoint](#v2accountrecipes)
`GW2Api::account()->recipes()`🔒/v2/account/skins[Account\\SkinEndpoint](#v2accountskins)
`GW2Api::account()->skins()`🔒/v2/account/titles[Account\\TitleEndpoint](#v2accounttitles)
`GW2Api::account()->titles()`🔒/v2/account/wallet[Account\\WalletEndpoint](#v2accountwallet)
`GW2Api::account()->wallet()`🔒/v2/achievements[Achievement\\AchievementEndpoint](#v2achievements)
`GW2Api::achievements()`📦🌏/v2/achievements/categories[Achievement\\CategoryEndpoint](#v2achievementscategories)
`GW2Api::achievements()->categories()`📦🌏/v2/achievements/daily[Achievement\\DailyEndpoint](#v2achievementsdaily)
`GW2Api::achievements()->daily()`/v2/achievements/daily/tomorrow[Achievement\\DailyTomorrowEndpoint](#v2achievementsdailytomorrow)
`GW2Api::achievements()->daily()->tomorrow()`/v2/achievements/groups[Achievement\\GroupEndpoint](#v2achievementsgroups)
`GW2Api::achievements()->groups()`📦🌏/v2/backstory/answers[Backstory\\AnswerEndpoint](#v2backstoryanswers)
`GW2Api::backstory()->answers()`📦🌏/v2/backstory/questions[Backstory\\QuestionEndpoint](#v2backstoryquestions)
`GW2Api::backstory()->questions()`📦🌏/v2/build[Build\\BuildEndpoint](#v2build)
`GW2Api::build()`/v2/characters[Character\\CharacterEndpoint](#v2characters)
`GW2Api::characters()`🔒📦/v2/characters/:id/backstory[Character\\BackstoryEndpoint](#v2charactersidbackstory)
`GW2Api::characters()->backstoryOf()`🔒/v2/characters/:id/core[Character\\CoreEndpoint](#v2charactersidcore)
`GW2Api::characters()->coreOf()`🔒/v2/characters/:id/crafting[Character\\CraftingEndpoint](#v2charactersidcrafting)
`GW2Api::characters()->craftingOf()`🔒/v2/characters/:id/equipment[Character\\EquipmentEndpoint](#v2charactersidequipment)
`GW2Api::characters()->equipmentOf()`🔒/v2/characters/:id/heropoints[Character\\HeropointEndpoint](#v2charactersidheropoints)
`GW2Api::characters()->heropointsOf()`🔒/v2/characters/:id/inventory[Character\\InventoryEndpoint](#v2charactersidinventory)
`GW2Api::characters()->inventoryOf()`🔒/v2/characters/:id/recipes[Character\\RecipeEndpoint](#v2charactersidrecipes)
`GW2Api::characters()->recipesOf()`🔒/v2/characters/:id/skills[Character\\SkillEndpoint](#v2charactersidskills)
`GW2Api::characters()->skillsOf()`🔒/v2/characters/:id/specializations[Character\\SpecializationEndpoint](#v2charactersidspecializations)
`GW2Api::characters()->specializationsOf()`🔒/v2/characters/:id/training[Character\\TrainingEndpoint](#v2charactersidtraining)
`GW2Api::characters()->trainingOf()`🔒/v2/colors[Color\\ColorEndpoint](#v2colors)
`GW2Api::colors()`📦🌏/v2/commerce/exchange[Commerce\\ExchangeEndpoint](#v2commerceexchange)
`GW2Api::commerce()->exchange()`/v2/commerce/listings[Commerce\\ListingEndpoint](#v2commercelistings)
`GW2Api::commerce()->listings()`📦/v2/commerce/prices[Commerce\\PriceEndpoint](#v2commerceprices)
`GW2Api::commerce()->prices()`📦/v2/commerce/transactions[Commerce\\Transaction\\TransactionEndpoint](#v2commercetransactions)
`GW2Api::commerce()->transactions()`🔒📄/v2/continents[Continent\\ContinentEndpoint](#v2continents)
`GW2Api::continents()`📦🌏/v2/currencies[Currency\\CurrencyEndpoint](#v2currencies)
`GW2Api::currencies()`📦🌏/v2/novelties[Novelty\\NoveltyEndpoint](#v2novelties)
`GW2Api::novelties()`📦🌏/v2/emblem[Emblem\\EmblemEndpoint](#v2emblem)
`GW2Api::emblem()`/v2/events*disabled*🌏🚫/v2/events-state*disabled*🚫/v2/files[File\\FileEndpoint](#v2files)
`GW2Api::files()`📦/v2/finishers[Finisher\\FinisherEndpoint](#v2finishers)
`GW2Api::finishers()`📦🌏/v2/guild/:id[Guild\\DetailsEndpoint](#v2guildid)
`GW2Api::guild()->detailsOf()`🔓/v2/guild/:id/log[Guild\\Authenticated\\LogEndpoint](#v2guildidlog)
`GW2Api::guild()->logOf()`🔒/v2/guild/:id/members[Guild\\Authenticated\\MemberEndpoint](#v2guildidmembers)
`GW2Api::guild()->membersOf()`🔒/v2/guild/:id/ranks[Guild\\Authenticated\\RankEndpoint](#v2guildidranks)
`GW2Api::guild()->ranksOf()`🔒/v2/guild/:id/stash[Guild\\Authenticated\\StashEndpoint](#v2guildidstash)
`GW2Api::guild()->stashOf()`🔒/v2/guild/:id/teams[Guild\\Authenticated\\TeamEndpoint](#v2guildidteams)
`GW2Api::guild()->teamsOf()`🔒/v2/guild/:id/treasury[Guild\\Authenticated\\TreasuryEndpoint](#v2guildidtreasury)
`GW2Api::guild()->treasuryOf()`🔒/v2/guild/:id/upgrades[Guild\\Authenticated\\UpgradeEndpoint](#v2guildidupgrades)
`GW2Api::guild()->upgradesOf()`🔒/v2/guild/permissions[Guild\\PermissionEndpoint](#v2guildpermissions)
`GW2Api::guild()->permissionsOf()`📦🌏/v2/guild/upgrades[Guild\\UpgradeEndpoint](#v2guildupgrades)
`GW2Api::guild()->upgradesOf()`📦🌏/v2/home/cats[Home\\CatEndpoint](#v2homecats)
`GW2Api::home()->cats()`📦/v2/home/nodes[Home\\NodeEndpoint](#v2homenodes)
`GW2Api::home()->nodes()`📦/v2/items[Item\\ItemEndpoint](#v2items)
`GW2Api::items()`📦🌏/v2/itemstats[Itemstat\\ItemstatEndpoint](#v2itemstats)
`GW2Api::itemstats()`📦🌏/v2/leaderboards*disabled*🚫/v2/legends[Legend\\LegendEndpoint](#v2legends)
`GW2Api::legends()`📦🌏/v2/maps[Map\\MapEndpoint](#v2maps)
`GW2Api::maps()`📦🌏/v2/masteries[Mastery\\MasteryEndpoint](#v2masteries)
`GW2Api::masteries()`📦🌏/v2/materials[Material\\MaterialEndpoint](#v2materials)
`GW2Api::materials()`📦🌏/v2/minis[Mini\\MiniEndpoint](#v2minis)
`GW2Api::minis()`📦🌏/v2/mounts/types[Mount\\TypeEndpoint](#v2mountstypes)
`GW2Api::mounts()->types()`📦🌏/v2/mounts/skins[Mount\\SkinEndpoint](#v2mountsskins)
`GW2Api::mounts()->skins()`📦🌏/v2/novelties[Novelty\\NoveltyEndpoint](#v2novelties)
`GW2Api::novelties()`📦🌏/v2/outfits[Outfit\\OutfitEndpoint](#v2outfits)
`GW2Api::outfits()`📦🌏/v2/pets[Pet\\PetEndpoint](#v2pets)
`GW2Api::pets()`📦🌏/v2/profession[Profession\\ProfessionEndpoint](#v2professions)
`GW2Api::professions()`📦🌏/v2/pvp/amulets[Pvp\\AmuletEndpoint](#v2pvpamulets)
`GW2Api::pvp()->amulets()`📦🌏/v2/pvp/games[Pvp\\GameEndpoint](#v2pvpgames)
`GW2Api::pvp()->games()`🔒📦/v2/pvp/seasons[Pvp\\SeasonEndpoint](#v2pvpseasons)
`GW2Api::pvp()->seasons()`📦🌏/v2/pvp/standings[Pvp\\StandingEndpoint](#v2pvpstandings)
`GW2Api::pvp()->standings()`🔒/v2/pvp/stats[Pvp\\StatsEndpoint](#v2pvpstats)
`GW2Api::pvp()->stats()`🔒/v2/quaggans[Quaggan\\QuagganEndpoint](#v2quaggans)
`GW2Api::quaggans()`📦/v2/recipes[Recipe\\RecipeEndpoint](#v2recipes)
`GW2Api::recipes()`📦/v2/recipes/search[Recipe\\SearchEndpoint](#v2recipessearch)
`GW2Api::recipes()->search()`/v2/skills[Skill\\SkillEndpoint](#v2skills)
`GW2Api::skills()`📦🌏/v2/skins[Skin\\SkinEndpoint](#v2skins)
`GW2Api::skins()`📦🌏/v2/specializations[Specialization\\SpecializationEndpoint](#v2specializations)
`GW2Api::specializations()`📦🌏/v2/stories[Story\\StoryEndpoint](#v2stories)
`GW2Api::stories()`📦🌏/v2/stories/seasons[Story\\SeasonEndpoint](#v2storiesseasons)
`GW2Api::stories()->season`📦🌏/v2/titles[Title\\TitleEndpoint](#v2titles)
`GW2Api::titles()`📦🌏/v2/tokeninfo[Tokeninfo\\TokeninfoEndpoint](#v2tokeninfo)
`GW2Api::tokeninfo()`🔒/v2/traits[Traits\\TraitEndpoint](#v2traits)
`GW2Api::traits()`📦🌏/v2/worlds[World\\WorldEndpoint](#v2worlds)
`GW2Api::worlds()`📦🌏/v2/wvw/abilities[WvW\\AbilityEndpoint](#v2wvwabilities)
`GW2Api::wvw()->abilities()`📦🌏/v2/wvw/matches[WvW\\MatchEndpoint](#v2wvwmatches)
`GW2Api::wvw()->matches()`📦/v2/wvw/objectives[WvW\\ObjectiveEndpoint](#v2wvwobjectives)
`GW2Api::wvw()->objectives()`📦🌏† Not FQN, all endpoints are in the namespace `\GW2Treasures\GW2Api\V2\Endpoint`
‡ Flags:
 [🔒AuthenticatedEndpoint](#authenticatedendpoint)
 [📦BulkEndpoint](#bulkendpoint)
 [🌏LocalizedEndpoint](#localizedendpoint)
 [📄PaginatedEndpoint](#paginatedendpoint)
 🚫Disabled in the API

### Abstract Endpoints

[](#abstract-endpoints)

#### AuthenticatedEndpoint

[](#authenticatedendpoint)

`\GW2Treasures\GW2Api\V2\Authentication\IAuthenticatedEndpoint` ([source](src/V2/Authentication/IAuthenticatedEndpoint.php))

All endpoints requiring authentication implement the interface `IAuthenticatedEndpoint`. Throws [AuthenticationException](#authenticationexception)and [InvalidPermissionsException](#invalidpermissionsexception).

#### BulkEndpoint

[](#bulkendpoint)

`\GW2Treasures\GW2Api\V2\Bulk\IBulkEndpoint` ([source](src/V2/Bulk/IBulkEndpoint.php))

All endpoints supporting bulk expansion implement the interface `IBulkEndpoint`. Extends [PaginatedEndpoint](#paginatedendpoint). Throws [PageOutOfRangeException](#pageoutofrangeexception).

##### Methods

[](#methods)

- `all():array` Get all entries.
    If the endpoint doesn't support `?ids=all` this falls back to [`PaginatedEndpoint::all()`](#paginatedendpoint).
- `ids():int[]|string[]` Get all ids.
- `get(int|string $id):mixed` Get a single entry by id.
- `many(int[]|string[] $ids):array` Get multiple entries by id.
- `IPaginatedEndpoint::page(int $page, [int $size]):array`Get a specific page of the endpoint.
- `IPaginatedEndpoint::batch([int $parallelRequests], Closure $callback):void`Get all entries in multiple small batches. The callback gets called with new entries until all entries have been processed.
    Signature of the callback: `function(array $entries):void`.

##### Example

[](#example)

```
$api->items()->all();
// => returns array with all items

$api->items()->ids();
// => returns array with all item ids

$api->items()->get(1);
// => returns item with id 1

$api->items()->many([1,2,3]);
// => returns items with ids 1, 2 and 3
```

#### LocalizedEndpoint

[](#localizedendpoint)

`\GW2Treasures\GW2Api\V2\Localization\ILocalizedEndpoint` ([source](src/V2/Localization/ILocalizedEndpoint.php))

All endpoints supporting localization implement the interface `ILocalizedEndpoint`. Defaults to `en`. Throws [InvalidLanguageException](#invalidlanguageexception).

##### Methods

[](#methods-1)

- `lang(string $lang):$this` Change the language of the endpoint.

##### Example

[](#example-1)

```
$api->items()->lang('de')->get(1)
// => returns german item 1
```

#### PaginatedEndpoint

[](#paginatedendpoint)

`\GW2Treasures\GW2Api\V2\Pagination\IPaginatedEndpoint` ([source](src/V2/Pagination/IPaginatedEndpoint.php))

All endpoints supporting pagination implement the interface `IPaginatedEndpoint`. Throws [PageOutOfRangeException](#pageoutofrangeexception).

##### Methods

[](#methods-2)

- `all():array` Get all entries.
    Requests all pages of this endpoint in parallel and returns the merged result.
- `page(int $page, [int $size]):array` Get a page of entries. The `$size` defaults to the maximum page size (200 for most endpoints).
- `batch([int $parallelRequests], Closure $callback):void`Get all entries in multiple small batches. The callback gets called with new entries until all entries have been processed.
    Signature of the callback: `function(array $entries):void`.

#### Example

[](#example-2)

```
$api->items()->all();
// => returns all items

$api->items()->page(0, 10);
// => returns first page of 10 items

$api->items()->batch(function($items) {
    // $items contains items of current batch.
    // gets called multiple times with different items untill all items have been processed.
});
```

#### RestrictedGuildEndpoint

[](#restrictedguildendpoint)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\IRestrictedGuildEndpoint` ([source](src/V2/Endpoint/Guild/IRestrictedGuildEndpoint.php))

All guild endpoints requiring you to be a member implement the interface `RestrictedGuildEndpoint`. Throws [GuildLeaderRequiredException](#guildleaderrequiredexception) or [MembershipRequiredException](#membershiprequiredexception).

### Exceptions

[](#exceptions)

#### ApiException

[](#apiexception)

`\GW2Treasures\GW2Api\Exception\ApiException` ([source](src/Exception/ApiException.php))

Gets thrown by all endpoints when the API returns an error. Extends `\Exception`.

##### Methods

[](#methods-3)

- `getResponse():ResponseInterface` The response that was returned by the API.

##### Example

[](#example-3)

```
try {
    $api->items()->get('invalid item id');
} catch(ApiException $exception) {
    $exception->getMessage() === "no such id"
}
```

#### AuthenticationException

[](#authenticationexception)

`\GW2Treasures\GW2Api\V2\Authentication\Exception\AuthenticationException`([source](src/V2/Authentication/Exception/AuthenticationException.php))

Gets thrown by [AuthenticatedEndpoints](#authenticatedendpoint) when the endpoint needs authentication but no API key was specified or the API key was invalid. Extends [ApiException](#apiexception).

##### Example

[](#example-4)

```
try {
    $api->account('INVALID_API_KEY')->get();
} catch(AuthenticationException $exception) {
    $exception->getMessage() === "invalid key"
}
```

#### InvalidPermissionsException

[](#invalidpermissionsexception)

`\GW2Treasures\GW2Api\V2\Authentication\Exception\InvalidPermissionsException`([source](src/V2/Authentication/Exception/InvalidPermissionsException.php))

Gets thrown by [AuthenticatedEndpoints](#authenticatedendpoint) when the API key is missing permissions to access the endpoint. Extends [AuthenticationException](#authenticationexception).

##### Methods

[](#methods-4)

- `getMissingScope():string` The permission that was missing to access the endpoint.

##### Example

[](#example-5)

```
try {
    $api->characters('API_KEY_WITHOUT_CHARACTERS_SCOPE')->get();
} catch(InvalidPermissionsException $exception) {
    $exception->getMessage() === "requires scope characters"
    $exception->getMissingScope() === "characters"
}
```

#### InvalidLanguageException

[](#invalidlanguageexception)

`\GW2Treasures\GW2Api\V2\Localization\Exception\InvalidLanguageException`([source](src/V2/Localization/Exception/InvalidLanguageException.php))

Gets thrown by [LocalizedEndpoints](#localizedendpoint) when the API responds with a different language than requested. Extends [ApiException](#apiexception).

##### Methods

[](#methods-5)

- `getRequestLanguage():string` The requested language.
- `getResponseLanguage():string` The language the API responded with.

##### Example

[](#example-6)

```
try {
    $api->items()->lang('invalid')->get(1);
} catch(InvalidLanguageException $exception) {
    $exception->getMessage() === "Invalid language (expected: invalid; actual: en)"
    $exception->getRequestLanguage() === "invalid"
    $exception->getResponseLanguage() === "en"
}
```

#### PageOutOfRangeException

[](#pageoutofrangeexception)

`\GW2Treasures\GW2Api\V2\Pagination\Exception\PageOutOfRangeException`([source](src/V2/Pagination/Exception/PageOutOfRangeException.php))

Gets thrown by [PaginatedEndpoints](#paginatedendpoint) when requesting a page that doesn't exist. Extends [ApiException](#apiexception).

##### Example

[](#example-7)

```
try {
    $api->items()->page(9001);
} catch(PageOutOfRangeException $exception) {
    $exception->getMessage() === "page out of range. Use page values 0 - 826."
}
```

#### GuildException

[](#guildexception)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Exception\GuildException`([source](src/V2/Endpoint/Guild/Exception/GuildException.php))

Parent class of all guild exceptions. Extends [ApiException](#apiexception).

#### GuildLeaderRequiredException

[](#guildleaderrequiredexception)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Exception\GuildLeaderRequiredException`([source](src/V2/Endpoint/Guild/Exception/GuildLeaderRequiredException.php))

Gets thrown by [RestrictedGuildEndpoint](#restrictedguildendpoint) when requesting informations of a guild you are not the leader of. Extends [GuildException](#guildexception).

##### Example

[](#example-8)

```
try {
    $api->guild()->membersOf('API_KEY', 'GUILD_ID_YOU_ARE_NOT_LEADER_OF');
} catch(GuildLeaderRequiredException $exception) {
    $exception->getMessage() === "access restricted to guild leaders"
}
```

#### MembershipRequiredException

[](#membershiprequiredexception)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Exception\GuildLeaderRequiredException`([source](src/V2/Endpoint/Guild/Exception/GuildLeaderRequiredException.php))

Gets thrown by [RestrictedGuildEndpoint](#restrictedguildendpoint) when requesting informations of a guild you are not a member of. Extends [GuildException](#guildexception).

##### Example

[](#example-9)

```
try {
    $api->guild()->membersOf('API_KEY', 'GUILD_ID_YOU_ARE_NOT_A_MEMBER_OF');
} catch(GuildLeaderRequiredException $exception) {
    $exception->getMessage() === "membership required"
}
```

### Endpoints

[](#endpoints)

#### /v2/account

[](#v2account)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\AccountEndpoint`([source](src/V2/Endpoint/Account/AccountEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-6)

- `get():mixed` Get basic account info.
- `bank():Account\BankEndpoint` Gets a new [Account\\BankEndpoint](#v2accountbank) instance.
- `materials():Account\MaterialEndpoint` Gets a new [Account\\MaterialEndpoint](#v2accountmaterials) instance.

##### Example

[](#example-10)

```
$api->account('API_KEY')->get();
// => { id: "account-guid", name: "Lawton.1234", … }
```

#### /v2/account/achievements

[](#v2accountachievements)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\AchievementEndpoint`([source](src/V2/Endpoint/Account/AchievementEndpoint.php))

The [AchievementEndpoint](#v2achievements) can be used to look up the achievements returned by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-7)

- `get():array` Get account achievement progression.

##### Example

[](#example-11)

```
$api->account('API_KEY')->achievements()->get();
// => [ { id: 1, current: 1, max: 1000, done: false }, … ]
```

#### /v2/account/bank

[](#v2accountbank)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\BankEndpoint`([source](src/V2/Endpoint/Account/BankEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-8)

- `get():array` Get account bank.

##### Example

[](#example-12)

```
$api->account('API_KEY')->bank()->get();
// => [ null, { id: 46774, slot: 1, count: 1 }, … ]
```

#### /v2/account/dyes

[](#v2accountdyes)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\DyeEndpoint`([source](src/V2/Endpoint/Account/DyeEndpoint.php))

The [ColorEndpoint](#v2colors) can be used to look up the colors used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-9)

- `get():array` Get unlocked dyes.

##### Example

[](#example-13)

```
$api->account('API_KEY')->dyes()->get();
// => [ 8, 12, 14, 17, … ]
```

#### /v2/account/finishers

[](#v2accountfinishers)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\FinisherEndpoint`([source](src/V2/Endpoint/Account/FinisherEndpoint.php))

The [FinisherEndpoint](#v2finishers) can be used to look up the finishers used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-10)

- `get():array` Get unlocked finishers.

##### Example

[](#example-14)

```
$api->account('API_KEY')->finishers()->get();
// => [ { id: 1, permanent: true }
```

#### /v2/account/inventory

[](#v2accountinventory)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\InventoryEndpoint`([source](src/V2/Endpoint/Account/InventoryEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-11)

- `get():array` Returns a list of item stacks representing the account's shared inventory slots.

##### Example

[](#example-15)

```
$api->account('API_KEY')->inventory()->get();
// => [ null, { id: 12138, count: 250 }, null ]
```

#### /v2/account/masteries

[](#v2accountmasteries)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\MasteryEndpoint`([source](src/V2/Endpoint/Account/MasteryEndpoint.php))

The [MasteryEndpoint](#v2masteries) can be used to get the masteries used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-12)

- `get():array` Get unlocked masteries.

##### Example

[](#example-16)

```
$api->account('API_KEY')->masteries()->get();
// => [ { id: 4, level: 4 }, … ]
```

#### /v2/account/materials

[](#v2accountmaterials)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\MaterialEndpoint`([source](src/V2/Endpoint/Account/MaterialEndpoint.php))

The [MaterialEndpoint](#v2materials) can be used to get the categories used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-13)

- `get():array` Get account material storage.

##### Example

[](#example-17)

```
$api->account('API_KEY')->materials()->get();
// => [ { id: 19699, category: 5, count: 250 }, … ]
```

#### /v2/account/minis

[](#v2accountminis)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\MiniEndpoint`([source](src/V2/Endpoint/Account/MiniEndpoint.php))

The [MiniEndpoint](#v2minis) can be used to look up the minis returned by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-14)

- `get():array` Get unlocked minis.

##### Example

[](#example-18)

```
$api->account('API_KEY')->minis()->get();
// => [ 1, 2, 3, 4, … ]
```

#### /v2/account/novelties

[](#v2accountnovelties)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\MiniEndpoint`([source](src/V2/Endpoint/Account/NoveltyEndpoint.php))

The [NoveltyEndpoint](#v2novelties) can be used to look up the minis returned by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-15)

- `get():array` Get unlocked novelties.

##### Example

[](#example-19)

```
$api->account('API_KEY')->novelties()->get();
// => [ 1, 2, 3, 4, … ]
```

#### /v2/account/recipes

[](#v2accountrecipes)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\RecipeEndpoint`([source](src/V2/Endpoint/Account/RecipeEndpoint.php))

The [RecipeEndpoint](#v2recipes) can be used to look up the recipes used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-16)

- `get():array` Get unlocked recipes.

##### Example

[](#example-20)

```
$api->account('API_KEY')->recipes()->get();
// => [ 104, 105, 106, 107, … ]
```

#### /v2/account/skins

[](#v2accountskins)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\SkinEndpoint`([source](src/V2/Endpoint/Account/SkinEndpoint.php))

The [SkinEndpoint](#v2skins) can be used to look up the skins used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-17)

- `get():array` Get unlocked skins.

##### Example

[](#example-21)

```
$api->account('API_KEY')->skins()->get();
// => [ 1, 2, 3, 4, … ]
```

#### /v2/account/titles

[](#v2accounttitles)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\TitleEndpoint`([source](src/V2/Endpoint/Account/TitleEndpoint.php))

The [TitleEndpoint](#v2titles) can be used to look up the titles used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-18)

- `get():array` Get unlocked titles.

##### Example

[](#example-22)

```
$api->account('API_KEY')->titles()->get();
// => [ 1, 17, 188, … ]
```

#### /v2/account/wallet

[](#v2accountwallet)

`\GW2Treasures\GW2Api\V2\Endpoint\Account\WalletEndpoint`([source](src/V2/Endpoint/Account/WalletEndpoint.php))

The [CurrencyEndpoint](#v2currencies) can be used to look up the currencies used by this endpoint. Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-19)

- `get():array` Get the account wallet.

##### Example

[](#example-23)

```
$api->account('API_KEY')->wallet()->get();
// => [ { id: 1, value: 234885 }, … ]
```

#### /v2/achievements

[](#v2achievements)

`\GW2Treasures\GW2Api\V2\Endpoint\Achievement\AchievementEndpoint`([source](src/V2/Endpoint/Achievement/AchievementEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-20)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)
- `categories():Achievement\CategoryEndpoint` Gets a new [Achievement\\CategoryEndpoint](#v2achievementscategories) instance.
- `daily():Achievement\DailyEndpoint` Gets a new [Achievement\\DailyEndpoint](#v2achievementsdaily) instance.
- `groups():Achievement\GroupEndpoint` Gets a new [Achievement\\GroupEndpoint](#v2achievementsgroups) instance.

##### Example

[](#example-24)

```
$api->achievements()->get(1);
// => { id: 1, name: "Centaur Slayer", … }
```

#### /v2/achievements/categories

[](#v2achievementscategories)

`\GW2Treasures\GW2Api\V2\Endpoint\Achievement\CategoryEndpoint`([source](src/V2/Endpoint/Achievement/CategoryEndpoint.php))

##### Methods

[](#methods-21)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-25)

```
$api->achievements()->categories()->get(50);
// => { id: 50, name: "Twilight Assault", … }
```

#### /v2/achievements/daily

[](#v2achievementsdaily)

`\GW2Treasures\GW2Api\V2\Endpoint\Achievement\DailyEndpoint`([source](src/V2/Endpoint/Achievement/DailyEndpoint.php))

##### Methods

[](#methods-22)

- `get():mixed` Get the current daily achievements.
- `tomorrow():DailyTomorrowEndpoint` Get tomorrows daily achievements.

##### Example

[](#example-26)

```
$api->achievements()->daily()->get();
// => { pve: [ { id: 1984, level: { min:1, max: 80 } }, … ], pvp: [ … ], wvw: [ … ] }
```

#### /v2/achievements/daily/tomorrow

[](#v2achievementsdailytomorrow)

`\GW2Treasures\GW2Api\V2\Endpoint\Achievement\DailyTomorrowEndpoint`([source](src/V2/Endpoint/Achievement/DailyTomorrowEndpoint.php))

##### Methods

[](#methods-23)

- `get():mixed` Get the current daily achievements.

##### Example

[](#example-27)

```
$api->achievements()->daily()->tomorrow()->get();
// => { pve: [ { id: 1973, level: { min:1, max: 79 } }, … ], pvp: [ … ], wvw: [ … ] }
```

#### /v2/achievements/groups

[](#v2achievementsgroups)

`\GW2Treasures\GW2Api\V2\Endpoint\Achievement\GroupEndpoint`([source](src/V2/Endpoint/Achievement/GroupEndpoint.php))

##### Methods

[](#methods-24)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-28)

```
$api->achievements()->groups()->get('65B4B678-607E-4D97-B458-076C3E96A810');
// => { id: "65B4B678-607E-4D97-B458-076C3E96A810", name: "Heart of Thorns", … }
```

#### /v2/backstory/answers

[](#v2backstoryanswers)

`\GW2Treasures\GW2Api\V2\Endpoint\Backstory\AnswerEndpoint`([source](src/V2/Endpoint/Backstory/AnswerEndpoint.php))

##### Methods

[](#methods-25)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-29)

```
$api->backstory()->answers()->get('7-54');
// => { id: "7-54", title: "Dignity", question: 7, … }
```

#### /v2/backstory/questions

[](#v2backstoryquestions)

`\GW2Treasures\GW2Api\V2\Endpoint\Backstory\QuestionEndpoint`([source](src/V2/Endpoint/Backstory/QuestionEndpoint.php))

##### Methods

[](#methods-26)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-30)

```
$api->backstory()->questions()->get('7');
// => { id: 7, title: "My Personality", answers: [ "7-53", "7-54", "7-55" ], … }
```

#### /v2/build

[](#v2build)

`\GW2Treasures\GW2Api\V2\Endpoint\Build\BuildEndpoint`([source](src/V2/Endpoint/Build/BuildEndpoint.php))

##### Methods

[](#methods-27)

- `get():int` Gets the current build id.

##### Example

[](#example-31)

```
$api->build()->get();
// => 50430
```

#### /v2/characters

[](#v2characters)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\CharacterEndpoint`([source](src/V2/Endpoint/Character/CharacterEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-28)

- `equipmentOf():Character\EquipmentEndpoint`Gets a new [Character\\EquipmentEndpoint](#v2charactersidequipment) instance.
- `inventoryOf():Character\InventoryEndpoint`Gets a new [Character\\InventoryEndpoint](#v2charactersidinventory) instance.
- `recipesOf():Character\RecipeEndpoint`Gets a new [Character\\RecipeEndpoint](#v2charactersidrecipes) instance.
- `specializationsOf():Character\SpecializationEndpoint`Gets a new [Character\\SpecializationEndpoint](#v2charactersidspecializations) instance.
- Inherited from [📦BulkEndpoint](#bulkendpoint).

##### Example

[](#example-32)

```
$api->characters('API_KEY')->get('Character Name');
// => { name: "Hello", race: "Human", … }
```

#### /v2/characters/:id/backstory

[](#v2charactersidbackstory)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\BackstoryEndpoint`([source](src/V2/Endpoint/Character/BackstoryEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-29)

- `get():array` Gets the characters backstory.

##### Example

[](#example-33)

```
$api->characters('API_KEY')->backstoryOf('Character Name')->get();
// => [ "26-122", "27-125", … ]
```

#### /v2/characters/:id/core

[](#v2charactersidcore)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\CoreEndpoint`([source](src/V2/Endpoint/Character/CoreEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-30)

- `get():array` Gets the core information of a character.

##### Example

[](#example-34)

```
$api->characters('API_KEY')->coreOf('Character Name')->get();
// => { name: "Test Char", race: "Norn", gender: "Female", … }
```

#### /v2/characters/:id/crafting

[](#v2charactersidcrafting)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\CraftingEndpoint`([source](src/V2/Endpoint/Character/CraftingEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-31)

- `get():array` Get the crafting information of a character.

##### Example

[](#example-35)

```
$api->characters('API_KEY')->craftingOf('Character Name')->get();
// => [ { discipline: "Tailor", rating: 400, active: true }, … ]
```

#### /v2/characters/:id/equipment

[](#v2charactersidequipment)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\EquipmentEndpoint`([source](src/V2/Endpoint/Character/EquipmentEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-32)

- `get():array` Gets the characters equipment.

##### Example

[](#example-36)

```
$api->characters('API_KEY')->equipmentOf('Character Name')->get();
// => [ { id: 6472, slot: "Coat" }, … ]
```

#### /v2/characters/:id/heropoints

[](#v2charactersidheropoints)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\HeropointEndpoint`([source](src/V2/Endpoint/Character/HeropointEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-33)

- `get():array` Gets the characters heropoints.

##### Example

[](#example-37)

```
$api->characters('API_KEY')->heropointsOf('Character Name')->get();
// => [ "0-3", "0-4", "0-5", "0-6", "0-8", … ]
```

#### /v2/characters/:id/inventory

[](#v2charactersidinventory)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\InventoryEndpoint`([source](src/V2/Endpoint/Character/InventoryEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-34)

- `get():array` Gets the characters inventory.

##### Example

[](#example-38)

```
$api->characters('API_KEY')->inventoryOf('Character Name')->get();
// => [ { id: 8941, size: 4 inventory: [ null, { id: 32134, count: 1 }, … ] }, … ]
```

#### /v2/characters/:id/recipes

[](#v2charactersidrecipes)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\RecipeEndpoint`([source](src/V2/Endpoint/Character/RecipeEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-35)

- `get():array` Get unlocked recipes of a character.

##### Example

[](#example-39)

```
$api->characters('API_KEY')->recipesOf('Character Name')->get();
// => [ 7, 8, 9, 10, 11, … ]
```

#### /v2/characters/:id/skills

[](#v2charactersidskills)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\SkillEndpoint`([source](src/V2/Endpoint/Character/SkillEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-36)

- `get():array` Gets the characters skills.

##### Example

[](#example-40)

```
$api->characters('API_KEY')->skillsOf('Character Name')->get();
// => { pve: { heal: 5503, utilities: [ 5641, 5734, 5502 ], elite: 5666 }, … }
```

#### /v2/characters/:id/specializations

[](#v2charactersidspecializations)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\SpecializationEndpoint`([source](src/V2/Endpoint/Character/SpecializationEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-37)

- `get():array` Gets the characters specializations.

##### Example

[](#example-41)

```
$api->characters('API_KEY')->specializationsOf('Character Name')->get();
// => { pve: [ { id: 41, traits: [232, 214, 226] }, … ], … }
```

#### /v2/characters/:id/training

[](#v2charactersidtraining)

`\GW2Treasures\GW2Api\V2\Endpoint\Character\TrainingEndpoint`([source](src/V2/Endpoint/Character/TrainingEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-38)

- `get():array` Gets the characters trainings.

##### Example

[](#example-42)

```
$api->characters('API_KEY')->trainingOf('Character Name')->get();
// => [ { id: 111, spent: 24, done: true }, … ]
```

#### /v2/colors

[](#v2colors)

`\GW2Treasures\GW2Api\V2\Endpoint\Color\ColorEndpoint`([source](src/V2/Endpoint/Color/ColorEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-39)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-43)

```
$api->colors()->lang('de')->all();
// => [ { id: 1, name: "Farbentferner", base_rgb: [128,26,26], … }, … ]
```

#### /v2/commerce/exchange

[](#v2commerceexchange)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\ExchangeEndpoint`([source](src/V2/Endpoint/Commerce/ExchangeEndpoint.php))

##### Methods

[](#methods-40)

- `gems(int $quantity):mixed` Current gem to coins exchange rate.
- `coins(int $quantity):mixed` Current coins to gems exchange rate.

##### Example

[](#example-44)

```
$api->commerce()->exchange()->gems(50);
// => { coins_per_gem: 1211, quantity: 60579 }
```

#### /v2/commerce/listings

[](#v2commercelistings)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\ListingEndpoint`([source](src/V2/Endpoint/Commerce/ListingEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-41)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-45)

```
$api->commerce()->listings()->get(24);
// => { id: 24, buys: [ { listings: 1, unit_price: 186, quantity: 250 }, … ] }
```

#### /v2/commerce/prices

[](#v2commerceprices)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\PriceEndpoint`([source](src/V2/Endpoint/Commerce/PriceEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-42)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-46)

```
$api->commerce()->prices()->get(24);
// => { id: 24, buys: { quantity: 20854, unit_price: 186 }, sells: { quantity: 9787, unit_price: 340 } }
```

#### /v2/commerce/transactions

[](#v2commercetransactions)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\Transaction\TransactionEndpoint`([source](src/V2/Endpoint/Commerce/Transaction/TransactionEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-43)

- `current():Commerce\Transaction\TypeEndpoint`Gets a new [Commerce\\Transaction\\TypeEndpoint](#v2commercetransactionstype) instance representing current transactions.
- `history():Commerce\Transaction\TypeEndpoint`Gets a new [Commerce\\Transaction\\TypeEndpoint](#v2commercetransactionstype) instance representing historic transactions.

#### /v2/commerce/transactions/:type

[](#v2commercetransactionstype)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\Transaction\TypeEndpoint`([source](src/V2/Endpoint/Commerce/Transaction/TypeEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-44)

- `buys():Commerce\Transaction\ListEndpoint`Gets a new [Commerce\\Transaction\\ListEndpoint](#v2commercetransactionstypelist) instance representing pending/completed buy transactions.
- `sells():Commerce\Transaction\ListEndpoint`Gets a new [Commerce\\Transaction\\ListEndpoint](#v2commercetransactionstypelist) instance representing pending/completed buy transactions.

#### /v2/commerce/transactions/:type/:list

[](#v2commercetransactionstypelist)

`\GW2Treasures\GW2Api\V2\Endpoint\Commerce\Transaction\ListEndpoint`([source](src/V2/Endpoint/Commerce/Transaction/ListEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [📄PaginatedEndpoint](#paginatedendpoint).

##### Methods

[](#methods-45)

- Inherited methods from [📄PaginatedEndpoint](#paginatedendpoint)

##### Example

[](#example-47)

```
$api->commerce()->transactions('API_KEY')->current()->sells()->all();
// => [ { id: 1999, item_id: 19699, price: 1004, quantity: 20, created: "2014-12-15T14:43:36+00:00" }, … ]
```

#### /v2/continents

[](#v2continents)

`\GW2Treasures\GW2Api\V2\Endpoint\Continent\ContinentEndpoint`([source](src/V2/Endpoint/Continent/ContinentEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-46)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)
- `floors(int $continent_id):Continent\FloorEndpoint` Gets a new [Continent\\FloorEndpoint](#v2continentsidfloors) instance.

##### Example

[](#example-48)

```
$api->continents()->get(1);
// => { name: "Tyria", … }
```

#### /v2/currencies

[](#v2currencies)

`\GW2Treasures\GW2Api\V2\Endpoint\Currency\CurrencyEndpoint`([source](src/V2/Endpoint/Currency/CurrencyEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-47)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-49)

```
$api->currencies()->get(1);
// => { id: 1, name: "Coin", … }
```

#### /v2/continents/:id/floors

[](#v2continentsidfloors)

`\GW2Treasures\GW2Api\V2\Endpoint\Continent\FloorEndpoint`([source](src/V2/Endpoint/Continent/FloorEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-48)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-50)

```
$api->continents()->floorsOf(1)->get(0);
// => { texture_dims: [ 32768, 32768 ], … }
```

#### /v2/emblem

[](#v2emblem)

`\GW2Treasures\GW2Api\V2\Endpoint\Emblem\EmblemEndpoint`([source](src/V2/Endpoint/Emblem/EmblemEndpoint.php))

##### Methods

[](#methods-49)

- `backgrounds():Emblem\LayerEndpoint`Gets a new [Emblem\\LayerEndpoint](#v2emblemtype) instance of all background layers.
- `foregrounds():Emblem\LayerEndpoint`Gets a new [Emblem\\LayerEndpoint](#v2emblemtype) instance of all foreground layers.

#### /v2/emblem/:type

[](#v2emblemtype)

`\GW2Treasures\GW2Api\V2\Endpoint\Emblem\LayerEndpoint`([source](src/V2/Endpoint/Emblem/LayerEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-50)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-51)

```
$api->emblem()->foregrounds()->get(1);
// => { id: 1, layers: [ "59641.png", "59643.png", "59645.png" ] }
```

#### /v2/files

[](#v2files)

`\GW2Treasures\GW2Api\V2\Endpoint\File\FileEndpoint`([source](src/V2/Endpoint/File/FileEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-51)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-52)

```
$api->files()->ids();
// => [ "map_complete", "map_dungeon", … ]
```

#### /v2/finishers

[](#v2finishers)

`\GW2Treasures\GW2Api\V2\Endpoint\Finisher\FinisherEndpoint`([source](src/V2/Endpoint/Finisher/FinisherEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-52)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-53)

```
$api->finishers()->get();
// => { id:1, name: "Rabbit Rank Finisher", … }
```

#### /v2/guild/:id

[](#v2guildid)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\DetailsEndpoint`([source](src/V2/Endpoint/Guild/DetailsEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint). The API key is optional.

##### Methods

[](#methods-53)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)
- `get():array` Get the guild details of a guild.

##### Example

[](#example-54)

```
$api->guild()->detailsOf('GUILD_ID');
// => { id: "GUILD_ID", name: "Test Guild", tag: "API", … }

$api->guild()->detailsOf('GUILD_ID', 'API_KEY');
// => { level: 42, motd: "gw2treasures.com\n", id: "GUILD_ID", name: "Test Guild", tag: "API", … }
```

#### /v2/guild/:id/log

[](#v2guildidlog)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\LogEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/LogEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-54)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-55)

```
$api->guild()->logOf('API_KEY', 'GUILD_ID');
// => [ { id: 1190, time: "…", type: "treasury", user: "Lawton Campbell.9413", … }, … ]
```

#### /v2/guild/:id/members

[](#v2guildidmembers)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\MemberEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/MemberEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-55)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-56)

```
$api->guild()->membersOf('API_KEY', 'GUILD_ID');
// => [ { name: "darthmaim.6017", rank: "Leader", joined: "2015-12-16T02:50:26.000Z" } ]
```

#### /v2/guild/:id/ranks

[](#v2guildidranks)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\RankEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/RankEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-56)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-57)

```
$api->guild()->ranksOf('API_KEY', 'GUILD_ID');
// => [ { id: "Leader", order: 1, permissions: [ "Admin", … ], icon: "…" }, … ]
```

#### /v2/guild/:id/stash

[](#v2guildidstash)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\StashEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/StashEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-57)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-58)

```
$api->guild()->stashOf('API_KEY', 'GUILD_ID')->get();
// => [ { upgrade_id: 1, size: 100, coins: 1002, note: "stash test", inventory: [] } ]
```

#### /v2/guild/:id/teams

[](#v2guildidteams)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\TeamEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/TeamEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-58)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-59)

```
$api->guild()->teamsOf('API_KEY', 'GUILD_ID')->get();
// => [ { id: 1, members: [], name: "ez game" } ]
```

#### /v2/guild/:id/treasury

[](#v2guildidtreasury)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\TreasuryEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/TreasuryEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-59)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-60)

```
$api->guild()->treasuryOf('API_KEY', 'GUILD_ID')->get();
// => [ { id: 123, count: 100, needed_by: [] } ]
```

#### /v2/guild/:id/upgrades

[](#v2guildidupgrades)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\Authenticated\UpgradeEndpoint`([source](src/V2/Endpoint/Guild/Authenticated/UpgradeEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [RestrictedGuildEndpoint](#restrictedguildendpoint).

##### Methods

[](#methods-60)

- Inherited methods from [🔒AuthenticatedEndpoint](#authenticatedendpoint)

##### Example

[](#example-61)

```
$api->guild()->upgradesOf('API_KEY', 'GUILD_ID')->get();
// => [ 38, 43, 44, 51, 55, … ]
```

#### /v2/guild/permissions

[](#v2guildpermissions)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\PermissionEndpoint`([source](src/V2/Endpoint/Guild/PermissionEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-61)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-62)

```
$api->guild()->permissions()->ids();
// => [ "ClaimableEditOptions", "EditBGM", "ActivatePlaceables", … ]
```

#### /v2/guild/upgrades

[](#v2guildupgrades)

`\GW2Treasures\GW2Api\V2\Endpoint\Guild\UpgradeEndpoint`([source](src/V2/Endpoint/Guild/UpgradeEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-62)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-63)

```
$api->guild()->upgrades()->get(38);
// => { id: 38, name: "Guild Armorer 1", … }
```

#### /v2/home/cats

[](#v2homecats)

`\GW2Treasures\GW2Api\V2\Endpoint\Home\CatEndpoint`([source](src/V2/Endpoint/Home/CatEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-63)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-64)

```
$api->home()->cats()->get('1');
// => { id: 1, hint: "chicken", … }
```

#### /v2/home/nodes

[](#v2homenodes)

`\GW2Treasures\GW2Api\V2\Endpoint\Home\NodeEndpoint`([source](src/V2/Endpoint/Home/NodeEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-64)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-65)

```
$api->mounts()->skins()->ids();
// => [ "advanced_cloth_rack", "advanced_leather_rack", … ]
```

#### /v2/items

[](#v2items)

`\GW2Treasures\GW2Api\V2\Endpoint\Item\ItemEndpoint`([source](src/V2/Endpoint/Item/ItemEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-65)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-66)

```
$api->items()->ids();
// => [ 1, 2, 6, 11, 24, … ]
```

#### /v2/itemstats

[](#v2itemstats)

`\GW2Treasures\GW2Api\V2\Endpoint\Itemstat\ItemstatEndpoint`([source](src/V2/Endpoint/Itemstat/ItemstatEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-66)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-67)

```
$api->itemstats()->get(137);
// => { id: 137, name: "Mighty", attributes: { Power: 0.35 } }
```

#### /v2/legends

[](#v2legends)

`\GW2Treasures\GW2Api\V2\Endpoint\Legend\LegendEndpoint`([source](src/V2/Endpoint/Legend/LegendEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-67)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-68)

```
$api->legends()->get('Legend1');
// => { id: "Legend1", swap: 28229, heal: 27220, … }
```

#### /v2/maps

[](#v2maps)

`\GW2Treasures\GW2Api\V2\Endpoint\Map\MapEndpoint`([source](src/V2/Endpoint/Map/MapEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-68)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-69)

```
$api->maps()->get(15);
// => { id: 15, name: "Queensdale", … }
```

#### /v2/masteries

[](#v2masteries)

`\GW2Treasures\GW2Api\V2\Endpoint\Mastery\MasteryEndpoint`([source](src/V2/Endpoint/Mastery/MasteryEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-69)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-70)

```
$api->masteries()->get(15);
// => { id: 1, name: "Exalted Lore", … }
```

#### /v2/materials

[](#v2materials)

`\GW2Treasures\GW2Api\V2\Endpoint\Material\MaterialEndpoint`([source](src/V2/Endpoint/Material/MaterialEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-70)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-71)

```
$api->materials()->lang('es')->all();
// => [ { id:5, name: "Materiales de cocina", items: [ 12134, … ] }, … ]
```

#### /v2/minis

[](#v2minis)

`\GW2Treasures\GW2Api\V2\Endpoint\Mini\MiniEndpoint`([source](src/V2/Endpoint/Mini/MiniEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-71)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-72)

```
$api->minis()->get(1);
// => { id: 1, name: "Miniature Rytlock", … }
```

#### /v2/mounts/types

[](#v2mountstypes)

`\GW2Treasures\GW2Api\V2\Endpoint\Mount\TypeEndpoint`([source](src/V2/Endpoint/Mount/TypeEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-72)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-73)

```
$api->mounts()->types()->get('raptor');
// => { id: "raptor", name: "Raptor", … }
```

#### /v2/mounts/skins

[](#v2mountsskins)

`\GW2Treasures\GW2Api\V2\Endpoint\Mount\SkinEndpoint`([source](src/V2/Endpoint/Mount/SkinEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-73)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-74)

```
$api->mounts()->skins()->get(1);
// => { id: 1, mount: "raptor", … }
```

#### /v2/novelties

[](#v2novelties)

`\GW2Treasures\GW2Api\V2\Endpoint\Novelty\NoveltyEndpoint`([source](src/V2/Endpoint/Novelty/NoveltyEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-74)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-75)

```
$api->novelties()->get(1);
// => { id: 1, name: "Embellished Kite", … }
```

#### /v2/outfits

[](#v2outfits)

`\GW2Treasures\GW2Api\V2\Endpoint\Outfit\OutfitEndpoint`([source](src/V2/Endpoint/Outfit/OutfitEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-75)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-76)

```
$api->outfits()->get(1);
// => { id: 1, name: "Cook's Outfit", … }
```

#### /v2/pets

[](#v2pets)

`\GW2Treasures\GW2Api\V2\Endpoint\Pet\PetEndpoint`([source](src/V2/Endpoint/Pet/PetEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-76)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-77)

```
$api->pets()->get(1);
// => { id: 1, name: "Juvenile Jungle Stalker", … }
```

#### /v2/professions

[](#v2professions)

`\GW2Treasures\GW2Api\V2\Endpoint\Profession\ProfessionEndpoint`([source](src/V2/Endpoint/Profession/ProfessionEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-77)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-78)

```
$api->professions()->get('Warrior');
// => { id: "Warrior", name: "Warrior", … }
```

#### /v2/pvp/amulets

[](#v2pvpamulets)

`\GW2Treasures\GW2Api\V2\Endpoint\Pvp\AmuletEndpoint`([source](src/V2/Endpoint/Pvp/AmuletEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-78)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-79)

```
$api->pvp()->amulets()->get(4);
// => { id: 4, name: "Assassin Amulet", … }
```

#### /v2/pvp/games

[](#v2pvpgames)

`\GW2Treasures\GW2Api\V2\Endpoint\Pvp\GameEndpoint`([source](src/V2/Endpoint/Pvp/GameEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint) and [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-79)

- Inherited from [📦BulkEndpoint](#bulkendpoint).

##### Example

[](#example-80)

```
$api->pvp('API_KEY')->games()->get('A9F9FD97-F114-4F97-B2CA-5E814DF0340E');
// => { id: "A9F9FD97-F114-4F97-B2CA-5E814DF0340E", map_id: 795, … }
```

#### /v2/pvp/seasons

[](#v2pvpseasons)

`\GW2Treasures\GW2Api\V2\Endpoint\Pvp\SeasonEndpoint`([source](src/V2/Endpoint/Pvp/SeasonEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-80)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-81)

```
$api->pvp()->seasons()->get('44B85826-B5ED-4890-8C77-82DDF9F2CF2B');
// => { id: "44B85826-B5ED-4890-8C77-82DDF9F2CF2B", name: "PvP League Season One", … }
```

#### /v2/pvp/standings

[](#v2pvpstandings)

`\GW2Treasures\GW2Api\V2\Endpoint\Pvp\StandingEndpoint`([source](src/V2/Endpoint/Pvp/StandingEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-81)

- `get():mixed` Get pvp standings.

##### Example

[](#example-82)

```
$api->pvp()->standings('API-KEY')->get();
// => [{ current: { total_points: 101, … }, best: { total_points: 200, … }, … }]
```

#### /v2/pvp/stats

[](#v2pvpstats)

`\GW2Treasures\GW2Api\V2\Endpoint\Pvp\StatsEndpoint`([source](src/V2/Endpoint/Pvp/StatsEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-82)

- `get():mixed` Get pvp stats.

##### Example

[](#example-83)

```
$api->pvp('API_KEY')->stats()->get();
// => { pvp_rank: 57, aggregate: { wins: 343, … }, … }
```

#### /v2/quaggans

[](#v2quaggans)

`\GW2Treasures\GW2Api\V2\Endpoint\Quaggan\QuagganEndpoint`([source](src/V2/Endpoint/Quaggan/QuagganEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-83)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)

##### Example

[](#example-84)

```
$api->quaggans()->many(['cheer', 'party']);
// => [ { id: "cheer", url: "cheer.jpg" }, { id: "party", url: "party.jpg" } ]
```

#### /v2/recipes

[](#v2recipes)

`\GW2Treasures\GW2Api\V2\Endpoint\Recipe\RecipeEndpoint`([source](src/V2/Endpoint/Recipe/RecipeEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-84)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- `search():Recipe\SearchEndpoint` Gets a new [Recipe\\SearchEndpoint](#v2recipessearch) instance.

##### Example

[](#example-85)

```
$api->recipes()->ids();
// => [ 1, 2, 3, 4, 5, … ]
```

#### /v2/recipes/search

[](#v2recipessearch)

`\GW2Treasures\GW2Api\V2\Endpoint\Recipe\SearchEndpoint`([source](src/V2/Endpoint/Recipe/SearchEndpoint.php))

##### Methods

[](#methods-85)

- `input(int $id):mixed` Searches for recipes with `$id` as ingredient.
- `output(int $id):mixed` Searches for recipes with `$id` as output.

##### Example

[](#example-86)

```
$api->recipes()->search()->input(43775);
// => [ 7259, 7260, 7261, 7262, … ]
```

#### /v2/skills

[](#v2skills)

`\GW2Treasures\GW2Api\V2\Endpoint\Skill\SkillEndpoint`([source](src/V2/Endpoint/Skill/SkillEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-86)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-87)

```
$api->skills()->get(1);
// => { name: "Bandage", facts: [ { text: "Recharge", type: "Recharge", icon: "…", value: 5 } ], … }
```

#### /v2/skins

[](#v2skins)

`\GW2Treasures\GW2Api\V2\Endpoint\Skin\SkinEndpoint`([source](src/V2/Endpoint/Skin/SkinEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-87)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-88)

```
$api->skins()->get(1);
// => { name: "Chainmail Leggings", type: "Armor", … }
```

#### /v2/specializations

[](#v2specializations)

`\GW2Treasures\GW2Api\V2\Endpoint\Specialization\SpecializationEndpoint`([source](src/V2/Endpoint/Specialization/SpecializationEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-88)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-89)

```
$api->specializations()->get(1);
// => { id: 1, name: "Dueling", profession: "Mesmer", … }
```

#### /v2/titles

[](#v2titles)

`\GW2Treasures\GW2Api\V2\Endpoint\Title\TitleEndpoint`([source](src/V2/Endpoint/Title/TitleEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-89)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-90)

```
$api->titles()->get(1);
// => { id: 1, name: "Traveler", achievement: 111 }
```

#### /v2/stories

[](#v2stories)

`\GW2Treasures\GW2Api\V2\Endpoint\Story\StoryEndpoint`([source](src/V2/Endpoint/Story/StoryEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-90)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)
- `seasons():Story\SeasonEndpoint` Gets a new [Story\\SeasonEndpoint](#v2storiesseasons) instance.

##### Example

[](#example-91)

```
$api->stories()->get(1);
// => { id: 1, season: "215AAA0F-CDAC-4F93-86DA-C155A99B5784", name: "My Story", … }
```

#### /v2/stories/seasons

[](#v2storiesseasons)

`\GW2Treasures\GW2Api\V2\Endpoint\Story\SeasonEndpoint`([source](src/V2/Endpoint/Story/SeasonEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-91)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-92)

```
$api->stories()->seasons()->get('215AAA0F-CDAC-4F93-86DA-C155A99B5784');
// => { id: "215AAA0F-CDAC-4F93-86DA-C155A99B5784", name: "My Story", … }
```

#### /v2/titles

[](#v2titles-1)

`\GW2Treasures\GW2Api\V2\Endpoint\Title\TitleEndpoint`([source](src/V2/Endpoint/Title/TitleEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-92)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-93)

```
$api->titles()->get(1);
// => { id: 1, name: "Traveler", achievement: 111 }
```

#### /v2/tokeninfo

[](#v2tokeninfo)

`\GW2Treasures\GW2Api\V2\Endpoint\Tokeninfo\TokeninfoEndpoint`([source](src/V2/Endpoint/Tokeninfo/TokeninfoEndpoint.php))

Implements [🔒AuthenticatedEndpoint](#authenticatedendpoint).

##### Methods

[](#methods-93)

- `get():mixed` Get info about the used api key.

##### Example

[](#example-94)

```
$api->tokeninfo('API_KEY')->get();
// => { id: "API_KEY", name: "key name", permissions: [ "account", … ] }
```

#### /v2/traits

[](#v2traits)

`\GW2Treasures\GW2Api\V2\Endpoint\Traits\TraitEndpoint`([source](src/V2/Endpoint/Traits/TraitEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-94)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-95)

```
$api->traits()->get(214);
// => { id: 214, tier:2, name: "Aeromancer's Training", … }
```

#### /v2/worlds

[](#v2worlds)

`\GW2Treasures\GW2Api\V2\Endpoint\World\WorldEndpoint`([source](src/V2/Endpoint/World/WorldEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-95)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-96)

```
$api->worlds()->all();
// => [ { id: 1001, name: "Anvil Rock" }, … ]
```

#### /v2/wvw/abilities

[](#v2wvwabilities)

`\GW2Treasures\GW2Api\V2\Endpoint\WvW\AbilityEndpoint`([source](src/V2/Endpoint/WvW/AbilityEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-96)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-97)

```
$api->wvw()->abilities()->get(2);
// => { id: 2, name: "Guard Killer", … }
```

#### /v2/wvw/matches

[](#v2wvwmatches)

`\GW2Treasures\GW2Api\V2\Endpoint\WvW\MatchEndpoint`([source](src/V2/Endpoint/WvW/MatchEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint).

##### Methods

[](#methods-97)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- `world(int $id):mixed` Get the current match of a world.

##### Example

[](#example-98)

```
$api->wvw()->matches()->get('2-6');

// => { id: "2-6", "scores": { red: 169331, blue: 246780, green: 216241 }, … }
```

#### /v2/wvw/objectives

[](#v2wvwobjectives)

`\GW2Treasures\GW2Api\V2\Endpoint\WvW\ObjectiveEndpoint`([source](src/V2/Endpoint/WvW/ObjectiveEndpoint.php))

Implements [📦BulkEndpoint](#bulkendpoint) and [🌏LocalizedEndpoint](#localizedendpoint).

##### Methods

[](#methods-98)

- Inherited methods from [📦BulkEndpoint](#bulkendpoint)
- Inherited methods from [🌏LocalizedEndpoint](#localizedendpoint)

##### Example

[](#example-99)

```
$api->wvw()->objectives()->get('968-98');

// => { id: "968-98", name: "Wurm Tunnel", … }
```

License
-------

[](#license)

[MIT](LICENSE) © 2015 gw2treasures.com

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 89.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~90 days

Recently: every ~446 days

Total

37

Last Release

821d ago

Major Versions

1.8.0 → 2.0.02015-10-10

2.4.0 → 3.0.0-RC2016-05-14

3.7.0 → 4.0.02023-05-10

PHP version history (3 changes)1.0.0PHP &gt;=5.4.0

2.0.0PHP &gt;=5.5.0

4.0.0PHP &gt;=7.2.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/64cef5580e3b14c57ba5a46dddf1b42bbc245a44656407ba98ef53e0597b653f?d=identicon)[darthmaim](/maintainers/darthmaim)

---

Top Contributors

[![darthmaim](https://avatars.githubusercontent.com/u/2511547?v=4)](https://github.com/darthmaim "darthmaim (353 commits)")[![chland](https://avatars.githubusercontent.com/u/472894?v=4)](https://github.com/chland "chland (21 commits)")[![Neofox](https://avatars.githubusercontent.com/u/6177937?v=4)](https://github.com/Neofox "Neofox (10 commits)")[![Aluquot](https://avatars.githubusercontent.com/u/11585717?v=4)](https://github.com/Aluquot "Aluquot (5 commits)")[![thom-10](https://avatars.githubusercontent.com/u/62172941?v=4)](https://github.com/thom-10 "thom-10 (3 commits)")[![irozgar](https://avatars.githubusercontent.com/u/1829877?v=4)](https://github.com/irozgar "irozgar (1 commits)")[![queicherius](https://avatars.githubusercontent.com/u/4615516?v=4)](https://github.com/queicherius "queicherius (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

apiapi-wrapperguildwars2gw2gw2-apiphpwrapperapiwrapperguild wars 2guildwars2

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/gw2treasures-gw2api/health.svg)

```
[![Health](https://phpackages.com/badges/gw2treasures-gw2api/health.svg)](https://phpackages.com/packages/gw2treasures-gw2api)
```

###  Alternatives

[gabrielbull/ups-api

PHP UPS API

4642.4M10](/packages/gabrielbull-ups-api)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)[walle89/swedbank-json

Unofficial API client for the Swedbank's and Sparbanken's mobile apps in Sweden.

752.5k](/packages/walle89-swedbank-json)[lasserafn/laravel-economic

Economic REST wrapper for Laravel

1118.5k](/packages/lasserafn-laravel-economic)[sysmoh/nextcloud-api-wrapper

A simple wrapper around nextcloud user provisioning api

177.3k2](/packages/sysmoh-nextcloud-api-wrapper)[lasserafn/php-dinero

Dinero REST wrapper for PHP

115.2k](/packages/lasserafn-php-dinero)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
