Versioning
Versioning helps the API users to smoothen the API upgrade process by providing a predictable new release and version deprecation schedule.
API users can manage their own system upgrade roadmap that fits their needs and no longer need to be bounded by the API version upgrade timeframe.
Making Requests
The API version is specified in the API endpoint URL. For AfterShip Tracking API, the URL would be:
The version number follows a date-based format like YYYY-MM. For example, for the tracking resource in Apr 2025, the complete URL would be:
Response Header
To discover the exact API version serving your request, check the API response header field named as-api-version.
| Header Name | Description | Format |
|---|---|---|
| as-api-version | The actual API version that serves the request. | YYYY-MM |
Sample Header Value
2024-07 2024-10 2025-01 2025-04 and so on.
Release schedule
Expect a new version of the AfterShip Tracking API every quarter, released on the 2nd Thursday of the 1st month of that quarter. The table below provides the release dates for the next 6 versions:
| Version | Release Date | Supported until |
|---|---|---|
| 2024-01 | 2024-01-11 | 2025-07-09 |
| 2024-04 | 2024-04-11 | 2025-10-08 |
| 2024-07 | 2024-07-11 | 2026-01-07 |
| 2024-10 | 2024-10-10 | 2026-04-08 |
| 2025-01 | 2025-01-09 | 2026-07-08 |
| 2025-04 | 2025-04-10 | 2026-10-08 |
Every API version enjoys support for a minimum of approximately 18 months, ensuring that the first version remains supported until the day before the release of the seventh version. This provides developers with a substantial overlap of at least 15 months between two consecutive stable versions, allowing them ample time to complete their API upgrading process.
Lifecycle and Deprecation Policy
We strongly recommend updating your integration to the latest API version every quarter in order to use our latest features. If a request is made to an unsupported API version, it will automatically redirect to the oldest supported API version.
For example, if you make a request to the API version 2025-01 after 2026-07-08, the request will be served by the API version 2025-04 (the oldest supported version).
Version Support Schedule Chart
