v3

latestOpenAPI 3.1.0raw.githubusercontent.com2025-07-02111260.6 KB
📦 Trackers

Create a tracker and get tracking results

This endpoint creates a new Tracker on the specified tracking number , if it does not exist, and returns the tracking results directly. We advise using this endpoint if you are not interested in receiving webhook notifications and just want to fetch tracking results. This way, you can always call this unified endpoint to get tracking results, without worrying about Tracker creation and management.

🛑 During the very first call for a tracking number, this endpoint will create a Tracker and try to return tracking results synchronously if the courier allows it, which can delay the initial answer, at the benefit of getting the tracking results from the first call. Initial response time may range from a few seconds, up to 1 minute, and results will depend on the courier's system availability at that time. Subsequent calls will be instantaneous as the Tracker will already exist with tracking results ready to use and constantly updated.

This endpoint is idempotent, any subsequent calls with the same parameters won't duplicate Tracker. However, providing different information in any of the fields will create a new Tracker as it will be considered as a new shipment.

post/public/v1/trackers/track

Request body

trackingNumberstring required

Tracking number of the shipment.

shipmentReferencestring

Your reference for this shipment. Will be provided in our webhooks or API responses for this tracker.

clientTrackerIdstring

Your unique identifier for this shipment. Will be provided in our webhooks or API responses for this tracker.

originCountryCodestring ISO 3166-1 alpha-2/alpha-3

Sender country code.

destinationCountryCodestring ISO 3166-1 alpha-2/alpha-3

Recipient country code - 📌 Recommended to improve tracking accuracy

destinationPostCodestring

Recipient Post code (or ZIP code) - 📌 Recommended to improve tracking accuracy

shippingDatestring date-time

Date at which the shipment has been shipped - 📌 Recommended to improve tracking accuracy: providing the shipping date helps us accurately identify the shipment and improves our ability to retrieve the correct data. However, an inaccurate shipping date could cause our system to exclude the right shipment. Therefore, please ensure the provided shipping date aligns closely with the actual shipment date, give or take a few days. Format

courierNamestring

Courier name and/or service.

trackingUrlstring

Tracking URL of the courier.

orderNumberstring

Order number in case of an eCommerce order.

titlestring

Title for this shipment, visible on the Tracking Dashboard.

Response

OK - Tracker already exists, returning tracking results