> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer-stage.shipbob.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-stage.shipbob.dev/_mcp/server. # Versioning Policy This guide outlines our approach to **versioning** and **deprecation**, helping developers\ build stable and future-proof integrations. ### **API Versioning** Starting **July 2025**, ShipBob is adopting a **date-based versioning scheme**\ using the format: > YYYY-MM ### **Current Version** * **Latest Version**: `2026-07` * **Base URL Format**: `https://api.shipbob.com/2026-07/` ### **Release Schedule** * A new version will be released **every 6 months** (January and July). * Each version will be **supported for 12 months** from its release date. ### **Version Lifecycle** | **Version** | **Release Date** | **End of Support** | | :---------- | :--------------- | :----------------- | | 2025-07 | Jul 31, 2025 | Jul 31, 2026 | | 2026-01 | Jan 31, 2026 | Jan 31, 2027 | | 2026-07 | Jul 31, 2026 | Jul 31, 2027 | ### **Legacy Version Deprecation** ShipBob previously used semantic versioning (`1.0` and`2.0`).\ These versions are now **deprecated**. ### **Deprecation Timeline** | **Legacy Version** | **Status** | **End of Support** | | :----------------- | :--------- | :----------------- | | 1.0 / 2.0 | Deprecated | Jul 31, 2026 | After the end-of-support date, legacy versions will no longer be accessible. ### **Experimental Features** ShipBob may release **experimental endpoints** to gather feedback and test new functionality. * Experimental endpoints are prefixed with `/experimental`. * These endpoints are **subject to change or removal without notice**. ### **Migration Assistance** For migration assistance or questions: * **Changelog**: [View API Changelog](https://developer.shipbob.com/release-notes) * **Email**: [support@shipbob.com](mailto:support@shipbob.com)