# ESI v4 Character Route Removed - Please Update to V5

**URL:** <https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374>\
**Category:** Third Party Developers\
**Tags:** esi, official, devblog\
**Created:** [October 27, 2021, 5:28pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374 "2021-10-27T17:28:44Z")\
**Posts on this page:** 13\
**Page:** 1

<div class="post-metadata">

**Author:** ![CCP\_Aurora](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/ccp_aurora/32/394780_2.png) [@CCP\_Aurora](https://forums.eveonline.com/u/CCP_Aurora)\
**Post date:** [October 27, 2021, 5:28pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/1 "2021-10-27T17:28:44Z")

</div>

To all of our third party developers,

Please note that version 4 of the character/{character\_id} route on ESI was removed last Monday (25 October). Any applications which were written using v4 of the character route need to be updated to v5.

The ESI changelog can be found at [esi-issues/changelog.md at master · esi/esi-issues · GitHub](https://github.com/esi/esi-issues/blob/master/changelog.md) where you can find the official documentation of changes made to ESI.

Related to this, we are currently seeing an increase in traffic to eve.character.skill endpoints since v4 character route was removed, possibly indicating applications which have started behaving poorly since this change.

If you maintain any applications which use the v4 character endpoint please ensure that they are updated to v5 as soon as possible, and help us make sure that your alliance IT teams and fellow third party developers are aware of this update.

Please also take this chance to inspect your usage of the various eve.character.skill endpoints both related and unrelated to this change.

If you have any questions about this then please point them to this thread and we will do our best to assist you.

---

<div class="post-metadata">

**Author:** ![CCP\_Aurora](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/ccp_aurora/32/394780_2.png) [@CCP\_Aurora](https://forums.eveonline.com/u/CCP_Aurora)\
**Post date:** [October 27, 2021, 5:29pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/2 "2021-10-27T17:29:18Z")

</div>



---

<div class="post-metadata">

**Author:** ![Kalbuir\_Skirate](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/kalbuir_skirate/32/294386_2.png) [@Kalbuir\_Skirate](https://forums.eveonline.com/u/Kalbuir_Skirate)\
**Post date:** [October 28, 2021, 8:44pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/3 "2021-10-28T20:44:56Z")

</div>

Heya I’m sorry,I think I can explain your weird spike in character skill hits.

I used it in our OAUTH 2.0 migration scripts the last 3 days to verify if everything was still in order for each character (before and after) migration. Considering the amount of tokens we have (Pandemic Horde’s IT) I wouldn’t be surprised if that is actually a noticeable spike on your monitoring.

---

<div class="post-metadata">

**Author:** ![CCP\_Aurora](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/ccp_aurora/32/394780_2.png) [@CCP\_Aurora](https://forums.eveonline.com/u/CCP_Aurora)\
**Post date:** [October 28, 2021, 10:23pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/4 "2021-10-28T22:23:48Z")

</div>

Haha, no worries! We’re just happy to hear people are noticing and updating.

---

<div class="post-metadata">

**Author:** ![CCP\_Explorer](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/ccp_explorer/32/385081_2.png) [@CCP\_Explorer](https://forums.eveonline.com/u/CCP_Explorer)\
**Post date:** [October 28, 2021, 10:45pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/5 "2021-10-28T22:45:56Z")

</div>

Hey @Kalbuir_Skirate: Can you confirm that you are still fetching this data? And if so, can you let us know when you are done?

Internally we got alerts on

- SkillHandler.GetAllSkills\_External
- SkillHandler.GetSkillPoints\_External
- SkillHandler.GetFreeSkillPoints\_External
- SkillHandler.GetAttributes\_External
- SkillHandler.GetImplants\_External
- SkillHandler.GetRespecInfo\_External
- charMgr.GetClones\_External

and it looks like the corresponding external calls are

- eve.character.skill.GetLearnedSkillsRequest
- eve.character.skill.GetCharacterAttributesRequest
- eve.character.implant.GetActiveImplantsByCharacterRequest
- eve.character.clone.GetClonesByCharacterRequest

and it looks like this:

 ![image](https://global.discourse-cdn.com/eveonline/original/4X/9/1/c/91ca06d2f623417ea6fc387ed6b90d66d44ad9e9.png)

Starts on Monday 25 Oct at approximately 14 o’clock UTC.

---

<div class="post-metadata">

**Author:** ![Kalbuir\_Skirate](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/kalbuir_skirate/32/294386_2.png) [@Kalbuir\_Skirate](https://forums.eveonline.com/u/Kalbuir_Skirate)\
**Post date:** [October 29, 2021, 6:58am UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/6 "2021-10-29T06:58:24Z")

</div>

Ah nope in that case we are not the culprit, only call I would have expected more requests on the  
“eve.character.skill.GetLearnedSkillsRequest” endpoint. Which I assume maps to `/characters/${character_id}/skills/` which stopped the 27th on our end. Looking at your graph it would not make a dent in your traffic as I also just realized the process did not scale and just did 1 continuous stream of API calls. So the TPS would be quite low as a result.

The script in question for migration of tokens was started on Monday morning and only ran during EU daytime as I wanted to monitor its progress. It stopped the evening of the 27th after it was completed. I’ve also verified there is no new behavior that does a new abnormal amount of API calls.

Furthermore

- eve.character.skill.GetCharacterAttributesRequest
- eve.character.implant.GetActiveImplantsByCharacterRequest
- eve.character.clone.GetClonesByCharacterRequest

Are not API calls we do in any ASYNC type process currently. On a final note, on all our API calls we have the User-Agent set as “Horde Square”.

Sorry 🙂

---

<div class="post-metadata">

**Author:** ![Keldek](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/keldek/32/293126_2.png) [@Keldek](https://forums.eveonline.com/u/Keldek)\
**Post date:** [October 29, 2021, 3:50pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/7 "2021-10-29T15:50:32Z")

</div>

Are you ever going to fix Developer Registration, or even acknowledge the problem directly?

---

<div class="post-metadata">

**Author:** ![Filo\_Fin\_Fain](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/filo_fin_fain/32/319634_2.png) [@Filo\_Fin\_Fain](https://forums.eveonline.com/u/Filo_Fin_Fain)\
**Post date:** [November 2, 2021, 12:41pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/8 "2021-11-02T12:41:29Z")

</div>

Your developer registration page has been broken for a month and many people have submitted a ticket over it. Hard to implement an ESI change without access.

---

<div class="post-metadata">

**Author:** ![Heritor\_Skoliya](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/heritor_skoliya/32/388743_2.png) [@Heritor\_Skoliya](https://forums.eveonline.com/u/Heritor_Skoliya)\
**Post date:** [November 3, 2021, 7:47am UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/9 "2021-11-03T07:47:33Z")

</div>

> [@CCP\_Aurora](#):
>
> Please note that version 4 of the character/{character\_id} route on ESI was removed last Monday (25 October). Any applications which were written using v4 of the character route need to be updated to v5.

Do I understand correctly that if you use `latest`, then you automatically use `v5`? And if `v5` will be updated to, let’s suppose, `v6` in future, you will automatically use `v6`, right?

---

<div class="post-metadata">

**Author:** ![CCP\_Aurora](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/ccp_aurora/32/394780_2.png) [@CCP\_Aurora](https://forums.eveonline.com/u/CCP_Aurora)\
**Post date:** [November 3, 2021, 7:50pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/10 "2021-11-03T19:50:45Z")

</div>

Yes, you can do this - but when updates are made your program may simply stop working until you update it and then you’d have to go fix it anyway, so that’s not really the way we recommend doing it.

---

<div class="post-metadata">

**Author:** ![Heritor\_Skoliya](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/heritor_skoliya/32/388743_2.png) [@Heritor\_Skoliya](https://forums.eveonline.com/u/Heritor_Skoliya)\
**Post date:** [November 4, 2021, 9:13am UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/11 "2021-11-04T09:13:43Z")

</div>

Actually, there’s almost no difference. When you use `v4`, you need to update your app to `v5` or it will not work just because `v4` route is removed. When you use `latest`, you need to update (or just to review) your app to make sure it understands new format.

But there is a reason why using `latest` is a better option than using versioned endpoint. When you use a versioned endpoint, and the support of this version is dropped, your app is started to be limited because it performs non-200 API calls. And, as I understand, in some cases you need to contact Customer Support Team to remove this limit. When you use `latest`, you most likely performs “HTTP code 200” requests (of course, if some required method parameters were not changed), and you only have internal application errors, not errors on API server (and then limits).

So, using the `latest` endpoint looks like a bit safer option. You can fix issues, and your app will start working right after it. And when you use versioned endpoints, in addition to code fixes, you most likely need to wait until limiting period is ended or is removed by Customer Support.

---

<div class="post-metadata">

**Author:** ![Golden\_Gnu](https://sea1.discourse-cdn.com/eveonline/user_avatar/forums.eveonline.com/golden_gnu/32/459734_2.png) [@Golden\_Gnu](https://forums.eveonline.com/u/Golden_Gnu)\
**Post date:** [November 4, 2021, 1:18pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/12 "2021-11-04T13:18:52Z")

</div>

In case you want to use versioned endpoints, you can check for the esi warning header to get advanced notices when a endpoint is moved to legacy, before it’s eventually removed and even when an update is available in dev:

> **[Warning Response Header](https://docs.esi.evetech.net/docs/warning_header.html)**
>
> The official repository for ESI documentation

If you’re worried about getting banned from ESI for errors, you should check and respect error limit headers:  
[https://developers.eveonline.com/blog/article/error-limiting-imminent](https://developers.eveonline.com/blog/article/error-limiting-imminent)

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/eveonline/original/3X/4/1/41ec4921cbaca7a6f9ea556e7cc20018461eae5e.png) [@system](https://forums.eveonline.com/u/system)\
**Post date:** [February 2, 2022, 1:19pm UTC](https://forums.eveonline.com/t/esi-v4-character-route-removed-please-update-to-v5/334374/13 "2022-02-02T13:19:08Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
