# API v2 info/documentation

**URL:** <https://forums.combatlogforums.com/t/api-v2-info-documentation/9975>\
**Category:** Warcraft Logs\
**Created:** [June 4, 2020, 9:00am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975 "2020-06-04T09:00:24Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![dkeulen](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/dkeulen/32/1487_2.png) [@dkeulen](https://forums.combatlogforums.com/u/dkeulen)\
**Post date:** [June 4, 2020, 9:00am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/1 "2020-06-04T09:00:24Z")

</div>

Hi there,

I saw there was now info available for the v2 api, but i was wondering if this info is complete/correct or the v2 api is not up yet?

I tried what was mentioned in the info under my account for v2 but what ever i try i get a 404 for the api url (currently trying the client/public section).

I am not sure but the url listed is [https://warcraftlogs/api/v2/x](https://warcraftlogs/api/v2/x), should this not be [https://warcraftlogs.COM/api/v2/x](https://warcraftlogs.COM/api/v2/x) ? or also a port added like v1? i tried all the url setups i can think of, no .com, with .com, with a port, with no port. without .com is does not find the host ofc and with .com and with or without a port i get a 404 for the v2 api.

I am using the insomnia client as suggested (with the oauth2.0 flow/token), and first off i get an ssl error, and then without ssl verification its a 404.

Any info or assistance would be appreciated for the v2 api.

Cheers.

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [June 4, 2020, 1:20pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/2 "2020-06-04T13:20:14Z")

</div>

v2 is still under development, so not really ready for production code yet. And yeah it should be [warcraftlogs.com](http://warcraftlogs.com) in the docs, will fix.

---

<div class="post-metadata">

**Author:** ![dkeulen](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/dkeulen/32/1487_2.png) [@dkeulen](https://forums.combatlogforums.com/u/dkeulen)\
**Post date:** [June 4, 2020, 1:34pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/3 "2020-06-04T13:34:12Z")

</div>

Cheers for the response.

Might i suggest that if it’s not ment to be “used/played with” yet, to remove any mention of the v2 api?  
Right now it looks like v2 is up and usable/viewable.

I was trying to see what endpoints where available, but how i read it nothing for the v2 api is live yet, including checking out its schema’s?

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [June 4, 2020, 4:01pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/4 "2020-06-04T16:01:53Z")

</div>

It is available. Follow the instructions in client credentials flow, use curl etc. to get an access token and then set your Authorization header to have the bearer access token in Insomnia.

---

<div class="post-metadata">

**Author:** ![Syno](https://avatars.discourse-cdn.com/v4/letter/s/3ec8ea/32.png) [@Syno](https://forums.combatlogforums.com/u/Syno)\
**Post date:** [June 12, 2020, 12:29pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/5 "2020-06-12T12:29:40Z")

</div>

In case anyone is still confused about the URL, it’s https://{site}.warcraftlogs.com/api/v2/client

For example, [https://classic.warcraftlogs.com/api/v2/client](https://classic.warcraftlogs.com/api/v2/client)

---

<div class="post-metadata">

**Author:** ![tcash21](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/tcash21/32/1547_2.png) [@tcash21](https://forums.combatlogforums.com/u/tcash21)\
**Post date:** [September 4, 2020, 10:08pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/6 "2020-09-04T22:08:59Z")

</div>

This brings me to the main classic warcraftlogs page, anyone else?

---

<div class="post-metadata">

**Author:** ![Mantikore](https://avatars.discourse-cdn.com/v4/letter/m/54ee81/32.png) [@Mantikore](https://forums.combatlogforums.com/u/Mantikore)\
**Post date:** [October 2, 2020, 9:50pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/7 "2020-10-02T21:50:35Z")

</div>

Hi there, I was interested in using the API to get some logs into an automation tool I’m trying to develop. Where can I get API documentation, i.e. samples, how-to’s, etc.?

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [October 2, 2020, 9:55pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/8 "2020-10-02T21:55:57Z")

</div>

v2 documentation appears inside whatever GraphQL tool/app you use.

---

<div class="post-metadata">

**Author:** ![Mantikore](https://avatars.discourse-cdn.com/v4/letter/m/54ee81/32.png) [@Mantikore](https://forums.combatlogforums.com/u/Mantikore)\
**Post date:** [October 2, 2020, 10:19pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/9 "2020-10-02T22:19:23Z")

</div>

Thanks for your quick reply. I’m using GraphQL Editor online just to play around, tried to load the schema from [https://classic.warcraftlogs.com/api/v2/client](https://classic.warcraftlogs.com/api/v2/client) and got the below error.

![image](https://canada1.discourse-cdn.com/flex029/uploads/combatlogforums/original/2X/e/eba2b3190585c79a45f77039918e921a0a1ad8f2.png)

I’m most likely using the wrong schema URL, amirite?

---

<div class="post-metadata">

**Author:** ![savagedragon](https://avatars.discourse-cdn.com/v4/letter/s/ebca7d/32.png) [@savagedragon](https://forums.combatlogforums.com/u/savagedragon)\
**Post date:** [December 25, 2020, 5:24am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/10 "2020-12-25T05:24:23Z")

</div>

I’m getting an empty response when I do the same. I seem to have a valid client token and was expecting schema info. Hopefully someone has some help here?

---

<div class="post-metadata">

**Author:** ![hobbesz](https://avatars.discourse-cdn.com/v4/letter/h/e19b73/32.png) [@hobbesz](https://forums.combatlogforums.com/u/hobbesz)\
**Post date:** [January 14, 2021, 6:13am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/11 "2021-01-14T06:13:25Z")

</div>

I’m experiencing the same thing, did you happen to figure it out? I’m a bit newbie at graphql but not sure what could be messing up my queries. I curled for an access token, posted it and using the schema to try to get any data coming back and everything is just a [] response.

---

<div class="post-metadata">

**Author:** ![sunday](https://avatars.discourse-cdn.com/v4/letter/s/3e96dc/32.png) [@sunday](https://forums.combatlogforums.com/u/sunday)\
**Post date:** [January 14, 2021, 3:40pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/12 "2021-01-14T15:40:39Z")

</div>

I’m trying to access the v2 documentation too. I’m successful with the call to get an authorization token but when I call the url provided ([https://www.warcraftlogs.com/api/v2/client](https://www.warcraftlogs.com/api/v2/client)) I just get a 302 Redirect to the home page. I’m using PHP: -

````auto
// Get an access token
$curl = curl_init();
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, array(
    'grant_type' => 'client_credentials',
    'client_id' => '????',
    'client_secret' => '????'
    ));
curl_setopt($curl, CURLOPT_URL, 'https://www.warcraftlogs.com/oauth/token');
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$result = curl_exec($curl);
$resultObject = json_decode($result, true);
// Call the API
$curl = curl_init();
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'authorization' => 'bearer ' . $resultObject['access_token']
));
curl_setopt($curl, CURLOPT_URL, 'https://www.warcraftlogs.com/api/v2/client');
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl);
?>```
````

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [January 14, 2021, 4:49pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/13 "2021-01-14T16:49:22Z")

</div>

make sure to add a json accept header.

---

<div class="post-metadata">

**Author:** ![caio](https://avatars.discourse-cdn.com/v4/letter/c/67e7ee/32.png) [@caio](https://forums.combatlogforums.com/u/caio)\
**Post date:** [January 21, 2021, 5:45am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/14 "2021-01-21T05:45:27Z")

</div>

I was able to run using Insomnia and using graphql queries. Something along the lines of:

 ![image](https://canada1.discourse-cdn.com/flex029/uploads/combatlogforums/original/2X/7/7d722508a1cfa54965be5c0a1907c37c376ecfc7.png)

Got the token using simple curl:

curl -u client\_id:secret -d grant\_type=client\_credentials [https://www.warcraftlogs.com/oauth/token](https://www.warcraftlogs.com/oauth/token)

And added both headers:

![image](https://canada1.discourse-cdn.com/flex029/uploads/combatlogforums/original/2X/d/d60f19aa0ace812a3a9d66206ce62fd06307ada8.png)

---

<div class="post-metadata">

**Author:** ![burik193](https://avatars.discourse-cdn.com/v4/letter/b/ee59a6/32.png) [@burik193](https://forums.combatlogforums.com/u/burik193)\
**Post date:** [February 28, 2021, 11:27pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/16 "2021-02-28T23:27:53Z")

</div>

Hello @Kihra! I just tried to get a documentation of v2 API access points. I’m using Insomnia client and was able to get Access Token, but struggling to get any response from [https://warcraftlogs.com/api/v2/client](https://warcraftlogs.com/api/v2/client). I did 2 headers as @caio did, but am not able to get a response from a server, it just says “Site not found”. Could you help me here?

It might be nice as well, if you list API access points on some page as it was for v1. I want to try and fetch some data for a small app for my guild with Python. Thanks!

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [March 1, 2021, 6:32am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/17 "2021-03-01T06:32:16Z")

</div>

Don’t leave off the www.

---

<div class="post-metadata">

**Author:** ![waffles](https://avatars.discourse-cdn.com/v4/letter/w/67e7ee/32.png) [@waffles](https://forums.combatlogforums.com/u/waffles)\
**Post date:** [March 2, 2021, 9:45pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/18 "2021-03-02T21:45:32Z")

</div>

Hi, I’m looking to use the GraphQL schema to retrieve all historical attendance data for a guild.

I can see that there is a has\_more\_pages field that returns a bool but I’m not sure how to iterate over the pages, essentially a GQL where statement that keeps running until has\_more\_pages returns false. Hoping someone can give me some advice, at the moment I’m just using the below code to manually pull the pages back.

> ```
> {
> guildData {
> guild(
> id:486350
> )
> {
> name
> attendance(page:1){data{zone{name},code,players{name}}}
> }
> }
> }
> 
> ```

---

<div class="post-metadata">

**Author:** ![Cautex](https://avatars.discourse-cdn.com/v4/letter/c/8dc957/32.png) [@Cautex](https://forums.combatlogforums.com/u/Cautex)\
**Post date:** [March 3, 2021, 7:02pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/19 "2021-03-03T19:02:01Z")

</div>

Hello, I am trying to retrieve the positioning data of bosses, but it appears that the API does not return this information . Are there plans for this data to be something that can be grabbed through the API? Or am I simply oblivious (I’m still very new to interacting with APIs so it’s entirely possible I’m just looking in the wrong place for this data)?

Thanks!

---

<div class="post-metadata">

**Author:** ![Kihra](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.combatlogforums.com/kihra/32/1116_2.png) [@Kihra](https://forums.combatlogforums.com/u/Kihra)\
**Post date:** [March 3, 2021, 7:33pm UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/20 "2021-03-03T19:33:27Z")

</div>

Position data is in the events in resources.

---

<div class="post-metadata">

**Author:** ![burik193](https://avatars.discourse-cdn.com/v4/letter/b/ee59a6/32.png) [@burik193](https://forums.combatlogforums.com/u/burik193)\
**Post date:** [March 23, 2021, 1:34am UTC](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975/21 "2021-03-23T01:34:08Z")

</div>

Hi. @Khira, I was able to use GraphQL, but didn’t found, how (given a report link) I get an information about all characters e.g. **their specs, covenants, etc** used on a given encounter ( just like one gets by looking at Summary at the web site). All I was able to retrieve were classes, but not specs etc. Would you please give me a hand at this, if it works this way at all?

[Next page](https://forums.combatlogforums.com/t/api-v2-info-documentation/9975.md?page=2)