📦 Trackers

Create a tracker and get tracking results

Changed on

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

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

Changes

    • breaking

      the ///// response's property format changed from date-time to no format for status

    • info

      added the non-success response with the status

    • info

      the response property became required for the status

    • info

      added the success response with the status

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      added the pattern ^[a-zA-Z0-9- ._/]*$ to the request property

    • warning

      deleted the header request parameter Authorization

    • warning

      deleted the header request parameter Content-Type

    • warning

      the request property's maxLength was set to 32

    • info

      the endpoint scheme security Authorization was added to the API

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status