Square API Versions

Square API Versions: the current version, recent changes and deprecations, from Square’s own docs.

Current version: 2026-09-16
Released: September 16, 2026
How versioning works: Date-based versions sent via the Square-Version header (default set per application); deprecated APIs are typically retired at least 12 months later and then return 410 GONE for every version.

The current Square API version is 2026-09-16, released September 16, 2026.

How versioning works. Date-based versions sent via the Square-Version header (default set per application); deprecated APIs are typically retired at least 12 months later and then return 410 GONE for every version.

Questions

What is the latest Square API version?

2026-09-16, released September 16, 2026.

What was the latest breaking change or deprecation?

September 16, 2026: Transactions API write operations (Charge, CreateRefund, CaptureTransaction, VoidTransaction) retired; reads remain.

Compare providers in the payment API changelog tracker.

Provider: Square
Recent changes: Date Version Type Change
September 16, 2026 2026-09-16 Retirement Transactions API write operations (Charge, CreateRefund, CaptureTransaction, VoidTransaction) retired; reads remain.
August 19, 2026 2026-08-19 New version Nested modifiers (beta) in Catalog, receipt fields on Location, new AMOUNT_TOO_LOW payment error code.
July 15, 2026 2026-07-15 Retirement Inventory TRANSFER change type, InventoryTransfer object, RetrieveInventoryTransfer and InventoryAdjustment.location_id retired; moves now modelled as adjustments.
May 20, 2026 2026-05-20 New version Payments app_fee_allocations across up to 3 parties, Apple Pay wallet_type, Japan e-money details.
April 21, 2026 2026-04-21 New version Reporting API (beta) launched with /v1/meta and /v1/load endpoints.
January 22, 2026 2026-01-22 Retirement Reader SDK and Mobile Authorization API retired; Reader SDK integrations can no longer take payments.
October 16, 2025 2025-10-16 New version Channels API and Transfer Orders API (beta) released.
February 20, 2025 2025-02-20 Deprecation Reader SDK and Mobile Authorization API deprecated, retirement set for 2025-12-31.
January 23, 2025 2025-01-23 Retirement Customer.cards field retired from this version onward; use ListCards/ListGiftCards.
Official changelog: developer.squareup.com
Versioning docs: developer.squareup.com
Sources: Source Link
Square changelog https://developer.squareup.com/docs/changelog/connect
Latest version https://developer.squareup.com/docs/changelog/connect-logs/2026-09-16
Inventory transfer model retired https://developer.squareup.com/docs/changelog/connect-logs/2026-07-15
Reader SDK retirement https://developer.squareup.com/docs/changelog/connect-logs/2026-01-22
Deprecation/retirement dates https://developer.squareup.com/docs/migrate-from-v1
Lifecycle policy https://developer.squareup.com/docs/build-basics/api-lifecycle
Customer.cards retirement https://developer.squareup.com/docs/changelog/connect-logs/2025-01-23
Last checked: September 30, 2026

Date	Version	Type	Change
September 16, 2026	2026-09-16	Retirement	Transactions API write operations (Charge, CreateRefund, CaptureTransaction, VoidTransaction) retired; reads remain.
August 19, 2026	2026-08-19	New version	Nested modifiers (beta) in Catalog, receipt fields on Location, new AMOUNT_TOO_LOW payment error code.
July 15, 2026	2026-07-15	Retirement	Inventory TRANSFER change type, InventoryTransfer object, RetrieveInventoryTransfer and InventoryAdjustment.location_id retired; moves now modelled as adjustments.
May 20, 2026	2026-05-20	New version	Payments app_fee_allocations across up to 3 parties, Apple Pay wallet_type, Japan e-money details.
April 21, 2026	2026-04-21	New version	Reporting API (beta) launched with /v1/meta and /v1/load endpoints.
January 22, 2026	2026-01-22	Retirement	Reader SDK and Mobile Authorization API retired; Reader SDK integrations can no longer take payments.
October 16, 2025	2025-10-16	New version	Channels API and Transfer Orders API (beta) released.
February 20, 2025	2025-02-20	Deprecation	Reader SDK and Mobile Authorization API deprecated, retirement set for 2025-12-31.
January 23, 2025	2025-01-23	Retirement	Customer.cards field retired from this version onward; use ListCards/ListGiftCards.

Source	Link
Square changelog	https://developer.squareup.com/docs/changelog/connect
Latest version	https://developer.squareup.com/docs/changelog/connect-logs/2026-09-16
Inventory transfer model retired	https://developer.squareup.com/docs/changelog/connect-logs/2026-07-15
Reader SDK retirement	https://developer.squareup.com/docs/changelog/connect-logs/2026-01-22
Deprecation/retirement dates	https://developer.squareup.com/docs/migrate-from-v1
Lifecycle policy	https://developer.squareup.com/docs/build-basics/api-lifecycle
Customer.cards retirement	https://developer.squareup.com/docs/changelog/connect-logs/2025-01-23

Source: each provider’s own changelog, API documentation and support pages, linked on each record. NY Presswire is not affiliated with these providers.