# API version 2 moving out of beta. Sunsetting API version 1

**URL:** <https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539>\
**Category:** Announcements\
**Created:** [March 13, 2020, 9:50pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539 "2020-03-13T21:50:52Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![viet](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/viet/32/41979_2.png) [@viet](https://community.wanikani.com/u/viet)\
**Post date:** [March 13, 2020, 9:50pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/1 "2020-03-13T21:50:52Z")

</div>

The time is finally here.

We are moving the [API version 2 out of beta](https://docs.api.wanikani.com/). We’re happy with the implementation and confidently moving forward replacing version 1 with version 2.

So, what does that mean for everyone?

# API version 1 will no longer be available

We plan on removing API version 1 on September 1, 2020. Once we sunset version 1, all the endpoints will return an [HTTP status code of 410](https://httpstatuses.com/410).

All API links reference on WaniKani app will be pointed to API version 2. A huge warning on the [API token settings page](https://www.wanikani.com/settings/personal_access_tokens) will be visible to discourage use of API version 1 tokens. We will also remove the beta notices on the API version 2 documentation.

The sunset date is a little less than six months from now, and we hope that gives everyone ample time to update the tools built on top of version 1.

# Why the deprecation of API version 1?

Version 1 was our first take at an API, and was made a long, long time ago. We’ve seen the amazing things everyone has built with it, felt the pain of using it ourselves, and learned a lot of lessons about structure and performance since then.

We didn’t make the decision lightly, but we made it so that we could spend our time and energy on making version 2 as robust and performant as possible.

Questions? Concerns? Curiousity? You can [review the v2 documentation](https://docs.api.wanikani.com/), catch up on [the long and winding journey of its development](https://community.wanikani.com/t/api-v2-beta-documentation/18987), or [drop us a note](mailto:hello@wanikani.com).

As always, thanks for being awesome and building awesome things on top of WaniKani!

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [March 15, 2020, 12:56am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/3 "2020-03-15T00:56:27Z")

</div>

Gone in 6 months, that is.

_Whew… I was really sweating for a moment there. But I can handle 6 months. I’m certain my schedule will slow down well before then._

---

<div class="post-metadata">

**Author:** ![UInt2048](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/uint2048/32/561086_2.png) [@UInt2048](https://community.wanikani.com/u/UInt2048)\
**Post date:** [March 15, 2020, 12:58am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/4 "2020-03-15T00:58:45Z")

</div>

> [@viet](#):
>
> all the endpoints will return an [HTTP status code of 410](https://httpstatuses.com/410)

Except on April 1, 00:00-23:59 PDT of every year after 2020, when this (hopefully) will be returned:

[![Imgur](https://global.discourse-cdn.com/wanikanicommunity/original/4X/1/5/8/158c913557f6933fe8f9f8ba4bee542ac4319c3b.jpeg "418 - I") ](https://www.flickr.com/photos/girliemac/6508102407/in/album-72157628409467125/)

**Edit:** If you actually want this, ask Viet. I can’t make that happen obviously! 😉

---

<div class="post-metadata">

**Author:** ![viet](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/viet/32/41979_2.png) [@viet](https://community.wanikani.com/u/viet)\
**Post date:** [March 15, 2020, 2:00am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/5 "2020-03-15T02:00:21Z")

</div>

Pinned globally on March 15, 2020, 2:00am UTC



---

<div class="post-metadata">

**Author:** ![rever4217](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rever4217/32/284602_2.png) [@rever4217](https://community.wanikani.com/u/rever4217)\
**Post date:** [March 15, 2020, 4:17am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/6 "2020-03-15T04:17:32Z")

</div>

Does this mean the golden age of wanikani is about to begin?

---

<div class="post-metadata">

**Author:** ![sornvru](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/sornvru/32/187517_2.png) [@sornvru](https://community.wanikani.com/u/sornvru)\
**Post date:** [March 15, 2020, 6:09am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/7 "2020-03-15T06:09:54Z")

</div>

Excellent. I’m glad to see the transition finally taking place.

---

<div class="post-metadata">

**Author:** ![searls](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/searls/32/8189_2.png) [@searls](https://community.wanikani.com/u/searls)\
**Post date:** [March 15, 2020, 6:44am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/8 "2020-03-15T06:44:50Z")

</div>

Congratulations! I feel like you handled the API transition very well overall!

---

<div class="post-metadata">

**Author:** ![acraney](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/acraney/32/296949_2.png) [@acraney](https://community.wanikani.com/u/acraney)\
**Post date:** [March 15, 2020, 9:43am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/9 "2020-03-15T09:43:06Z")

</div>

I couldn’t get the API 2 to work with wkstats. It would only seemingly work for me with API 1.

Can anyone offer a bit of help so I can continue using wkstats with API 2? Cheers in advance 🙂

---

<div class="post-metadata">

**Author:** ![NicoleIsEnough](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/nicoleisenough/32/87285_2.png) [@NicoleIsEnough](https://community.wanikani.com/u/NicoleIsEnough)\
**Post date:** [March 15, 2020, 10:03am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/10 "2020-03-15T10:03:36Z")

</div>

I think you need to use the WKStats V2 beta in order for the API 2 key to work. You can find it at [https://www.wkstats.com:10001](https://www.wkstats.com:10001)

---

<div class="post-metadata">

**Author:** ![acraney](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/acraney/32/296949_2.png) [@acraney](https://community.wanikani.com/u/acraney)\
**Post date:** [March 15, 2020, 10:11am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/11 "2020-03-15T10:11:03Z")

</div>

Awesome. Thanks so much.

---

<div class="post-metadata">

**Author:** ![plantron](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/plantron/32/783203_2.png) [@plantron](https://community.wanikani.com/u/plantron)\
**Post date:** [March 15, 2020, 10:37am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/12 "2020-03-15T10:37:37Z")

</div>

> [@rfindley](#):
>
> _I’m certain my schedule will slow down well before then._

Unless there’s another pandemic…

---

<div class="post-metadata">

**Author:** ![UInt2048](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/uint2048/32/561086_2.png) [@UInt2048](https://community.wanikani.com/u/UInt2048)\
**Post date:** [March 15, 2020, 4:16pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/13 "2020-03-15T16:16:41Z")

</div>

_Cue emergency reserves of NicCageVirus-20xx_

---

<div class="post-metadata">

**Author:** ![tip](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/tip/32/219684_2.png) [@tip](https://community.wanikani.com/u/tip)\
**Post date:** [March 15, 2020, 4:30pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/14 "2020-03-15T16:30:57Z")

</div>

@ZenBrayn will explorer make the transition to API 2?

---

<div class="post-metadata">

**Author:** ![Belerith](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/belerith/32/518237_2.png) [@Belerith](https://community.wanikani.com/u/Belerith)\
**Post date:** [March 15, 2020, 5:40pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/15 "2020-03-15T17:40:27Z")

</div>

😮

---

<div class="post-metadata">

**Author:** ![l\_l](https://cdck-file-uploads-global.s3.dualstack.us-west-2.amazonaws.com/wanikanicommunity/original/3X/f/d/fd4c154120954695f788402f3bcf4e616499bc2d.png) [@l\_l](https://community.wanikani.com/u/l_l)\
**Post date:** [March 15, 2020, 6:15pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/16 "2020-03-15T18:15:07Z")

</div>

Or you can just go to [wkstats](https://www.wkstats.com/v2)

---

<div class="post-metadata">

**Author:** ![Sezme](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/sezme/32/223482_2.png) [@Sezme](https://community.wanikani.com/u/Sezme)\
**Post date:** [March 16, 2020, 3:34am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/17 "2020-03-16T03:34:19Z")

</div>

I hope this doesn’t mean that my old beloved copy of AlliCrab will stop working.

---

<div class="post-metadata">

**Author:** ![UInt2048](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/uint2048/32/561086_2.png) [@UInt2048](https://community.wanikani.com/u/UInt2048)\
**Post date:** [March 17, 2020, 12:17am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/18 "2020-03-17T00:17:52Z")

</div>

Don’t worry - AlliCrab has been using v2 for years.

Here’s some free evidence, in case you forgot which API key you put in:

> <https://github.com/cplaverty/KeitaiWaniKani/pull/12>
>
> Just made a small fix which stopped the app from working, due a recent v2 API br…eaking change as per https://community.wanikani.com/t/api-v2-alpha-documentation/18987/358
> 
> This might not be the way you'd prefer to fix it (wasn't sure if you would rename the table fields, although that would require some migration of the data I guess), but obviously feel free to discard if you don't want to use this, it's a tiny patch :)
> 
> P.S. Thanks for making the app in the first place, it's really great.

---

<div class="post-metadata">

**Author:** ![Sezme](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/sezme/32/223482_2.png) [@Sezme](https://community.wanikani.com/u/Sezme)\
**Post date:** [March 17, 2020, 1:02am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/19 "2020-03-17T01:02:51Z")

</div>

Oh I know that I put in the v1 key until now. Good to see that the v2 key works as well.

---

<div class="post-metadata">

**Author:** ![Sezme](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/sezme/32/223482_2.png) [@Sezme](https://community.wanikani.com/u/Sezme)\
**Post date:** [March 17, 2020, 1:36am UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/21 "2020-03-17T01:36:39Z")

</div>

Yes, I logged out and logged back in successfully with the v2 key.

---

<div class="post-metadata">

**Author:** ![UInt2048](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/uint2048/32/561086_2.png) [@UInt2048](https://community.wanikani.com/u/UInt2048)\
**Post date:** [March 18, 2020, 1:32pm UTC](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539/22 "2020-03-18T13:32:05Z")

</div>

That’s just there in case you can’t access the port, which is actually going to be updated.

~~Sooner or later, it won’t matter at all, right?~~

[Next page](https://community.wanikani.com/t/api-version-2-moving-out-of-beta-sunsetting-api-version-1/42539.md?page=2)
