generated: '2026-10-12'
method: searched
source:
- https://developer.squareup.com/docs/build-basics/versioning-overview
- https://developer.squareup.com/docs/build-basics/api-lifecycle
name: Square API Lifecycle
versioning:
  scheme: date-based API versions selected per request with the Square-Version header
  header: Square-Version
  default: "The default API version is pinned to the application and used for all API requests unless overridden in the Square-Version header."
  docs: https://developer.squareup.com/docs/build-basics/versioning-overview
stages: [Beta, General Availability, Deprecated, Retired]
deprecation:
  policy: "APIs are deprecated as the first stage toward retirement. They're typically deprecated at least 12 months before permanent retirement."
  notice_period: at least 12 months (typical)
  url: https://developer.squareup.com/docs/migrate-from-v1/current-status
  docs: https://developer.squareup.com/docs/build-basics/api-lifecycle
status_page: https://www.issquareup.com/