> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.shipbob.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.shipbob.com/_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 24 months** from its release date.

### **Version Lifecycle**

| **Version** | **Release Date** | **End of Support** | **Upgrade Guide**                                          |
| :---------- | :--------------- | :----------------- | :--------------------------------------------------------- |
| 2025-07     | Jul 31, 2025     | Jul 31, 2027       | [Upgrade to 2025-07](/versioning/2025-07) (from `2.0`)     |
| 2026-01     | Jan 31, 2026     | Jan 31, 2028       | [Upgrade to 2026-01](/versioning/2026-01) (from `2025-07`) |
| 2026-07     | Jul 31, 2026     | Jul 31, 2028       | [Upgrade to 2026-07](/versioning/2026-07) (from `2026-01`) |

### **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:

* **Upgrade guides**: [Upgrade to 2025-07](/versioning/2025-07), [Upgrade to 2026-01](/versioning/2026-01), [Upgrade to 2026-07](/versioning/2026-07)\
  Each guide lists the changes for a single version step. Apply them in order if you are more than one version behind.
* **Changelog**: [View API Changelog](/release-notes)
* **Email**: [<u>support@shipbob.com</u>](mailto:support@shipbob.com)