# API retirement policy

**URL:** <https://developer.squareup.com/forums/t/api-retirement-policy/10441>\
**Category:** Questions\
**Created:** [August 23, 2023, 6:14pm UTC](https://developer.squareup.com/forums/t/api-retirement-policy/10441 "2023-08-23T18:14:47Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![FRibeiro](https://avatars.discourse-cdn.com/v4/letter/f/a5b964/32.png) [@FRibeiro](https://developer.squareup.com/forums/u/FRibeiro)\
**Post date:** [August 23, 2023, 6:14pm UTC](https://developer.squareup.com/forums/t/api-retirement-policy/10441/1 "2023-08-23T18:14:47Z")

</div>

Hey Square people!

We currently depend on version 2020-12-16 of the square API. I assume it is already deprecated, since the [api-lifecycle](https://developer.squareup.com/docs/build-basics/api-lifecycle) says it is 12 months. We are working on starting the migration of this to the most up-to-date API, but this involves many of our resources, so we need a deadline for the retirement of that version, or at least a timeframe where the API in question would be available.

Could someone clarify what is the retirement policy? Is there some defined timeline, it depends on the API version in question and its user base (most likely), and if so, what is it for my specific version? I found [this answer](https://developer.squareup.com/forums/t/api-versions-and-deprecation-to-retired-timeframe/3846/2), but it does not mention the timeframe.

All I want is to be ahead of the curve and avoid headaches for our dev team, like “Hey, payments are not working, we need to fix ASAP” and we need to migrate the whole thing on short notice. We plan to do this in 4 months from now give or take, but if retirement is coming soon, we would update the priority of it.

Thanks for the support!

---

<div class="post-metadata">

**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\
**Post date:** [August 23, 2023, 6:29pm UTC](https://developer.squareup.com/forums/t/api-retirement-policy/10441/2 "2023-08-23T18:29:23Z")

</div>

At this time we haven’t retired an API version. All of our versions are still supported. We do recommend staying current with our APIs. 🙂

---

<div class="post-metadata">

**Author:** ![FRibeiro](https://avatars.discourse-cdn.com/v4/letter/f/a5b964/32.png) [@FRibeiro](https://developer.squareup.com/forums/u/FRibeiro)\
**Post date:** [August 24, 2023, 9:05pm UTC](https://developer.squareup.com/forums/t/api-retirement-policy/10441/3 "2023-08-24T21:05:53Z")

</div>

Thanks for the reply, Bryan! That clarifies the issue for us.