***

title: Versioning Policy
last-updated: 'February 24, 2026'
---------------------------------

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-01`
* **Base URL Format**: `https://api.shipbob.com/2026-01/`

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

<Warning>
  ShipBob previously used semantic versioning (`1.0` and`2.0`).\
  These versions are now **deprecated**.
</Warning>

### **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**: [<u>techspecialists@shipbob.com</u>](mailto:techspecialists@shipbob.com)