Learn about depreciated APIs and how to migrate your code to use the replacement Square APIs.
The following sections list the Square APIs that are deprecated and scheduled for retirement and where you can get help migrating from deprecated APIs. For information about the path from API deprecation to retirement, see Square API Lifecycle.
The following Square APIs are deprecated and scheduled for retirement or recently retired and no longer supported. For detailed guidance about migrating your code to use the replacement Square API, refer to the migration guide provided in the table for the deprecated API.
The following Square APIs and SDKs are deprecated.
| API | Replacement | Deprecation | Retirement |
|---|---|---|---|
| Employees | Team API Migration guide | 2020-08-26 | 2021-08-26 |
| Transactions | Payments API Migration guide | 2019-08-15 | TBD |
| Reader SDK | Mobile Payments SDK Migration guide | 2025-02-20 | 2025-12-31 |
| Mobile Authorization | Mobile Payments SDK Migration guide | 2025-02-20 | 2025-12-31 |
Note
Square APIs that are in the General Availability (GA) or Beta state might have deprecated endpoints and webhooks or deprecated objects, fields, enums, and values.
If you have questions or need help migrating from deprecated APIs, contact Developer Support, join our Discord community, or reach out to your Square account manager.
Your code will break.
Retired functionality cannot be used, regardless of the Square-Version provided during the API call. REST calls that attempt to use retired functionality return errors. Square SDKs released on or after retirement don't include retired features.