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.
To prepare your system for migration now, select the upcoming version from the dropdown on the left side of this page, then check the "Migration Guide". Remember, the upcoming version will not go live until October 12.
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 October 2023, the complete URL would be:
To discover the exact API version serving your request, check the API response header field named
|as-api-version||The actual API version that serves the request.||YYYY-MM|
2024-07 and so on.
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|
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.
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
2023-10 after 2025-04-09, the request will be served by the API version
2024-01 (the oldest supported version).