📦 Trackers | Ship24 - Tracking API Documentation (2024)

Introduction to Tracker​

In order to have Ship24 track your shipments, you need to create a Tracker for each shipment on which you wish to receive tracking results. A Tracker is basically an instruction for Ship24 to track a shipment and is composed of a tracking number and a few shipment-related information such as courier information, origin country, destination country, etc.

Trackings endpoints overview​

A Tracker can be created using one of the following endpoints:

• Create tracker POST /v1/trackers

Create a new tracker, which means you are asking Ship24 to start tracking this shipment based on its tracking number.

• Create tracker and get tracking results POST /v1/trackers/track

Create a new tracker and get tracking results synchronously. As tracking results are fetched synchronously from couriers, the initial response time of the API may be up to one minute.

See Also

Versandverfolgung | Universelle Versandverfolgung - Ship24

Once created, a Tracker will track the corresponding shipment by automatically and continuously gathering the tracking results from the different couriers and sources of data.

Tracker can be viewed and modified using the following endpoints:

• Update an existing tracker PATCH /v1/trackers/:trackerId

Update an existing tracker by id. Data related to the shipment (i.e. destination country, shipping date) can't be modified if the Tracker already gathered shipment tracking information. Updating a Tracker is recommended in case you wish to provide additional courierCode afterward, however, it's best to provide all recommended information at the creation of a Tracker.

• Get an existing tracker GET /v1/trackers/:trackerId

Get an existing tracker by id. Please note that this endpoint will only return the Tracker information and not the tracking result. See Get tracker results by id or Get tracker results by tracking number to get the tracking result.

• Get existing trackers GET /v1/trackers

Get the list of existing trackers, using page-based pagination.

Tracking results from a Tracker can be retrieved in different ways:

1- Automatically receive webhook notifications for new tracking results. See webhooks.

This is the most efficient way to receive tracking results as you don't need to call our system at regular intervals, and you get informed as soon as we discover new events.

2- Fetch instantly the latest tracking results from our system using one of the following endpoints:

• Get results for an existing tracker GET /v1/trackers/:trackerId/results

If you store Ship24's trackerId in your system, this is the best way to fetch tracking results from an existing Tracker.

• Get tracker results by tracking number GET /v1/trackers/search/:trackingNumber/results

If you don't wish to store Ship24's trackerId in your system, you can use this endpoint to search a Tracker by tracking number. However, if you create two different Tracker for two different shipments going to two different destination countries with different couriers, that have the same tracking number, you will get an array of Tracker as a response. As tracking numbers are not unique, we always recommend using Get results for an existing tracker with Ship24's trackerId instead.

• Create tracker and get results POST /v1/trackers/track

As this endpoint is idempotent, it can be used initiallyto create the Tracker and get tracking results, and later on to get subsequent results by calling it again. This is the simplest way if you wish to have just one unified endpoint that can be called again and again to get tracking results. However, make sure the payload sent is always the same, as a new Tracker will be created if any information in the payload changes, and keep in mind that the initial call will be long, as explained in the endpoint definition.