Skip to main content

Tracking

Every shipment has a public tracking_code you share with your end customer. The tracking experience is hosted by Dodo — you don't run a tracking endpoint yourself.

Tracking code​

When you create a shipment, the response includes:

{
  "tracking_code": "DODO7K9M2P4QR8",
  ...
}

The code format is DODO + 10 alphanumeric characters. It's globally unique and unguessable.

Tracking URL​

Format:

https://dododelivery.co.tz/track?code={tracking_code}

Example:

https://dododelivery.co.tz/track?code=DODO7K9M2P4QR8

The page shows:

  • Current shipment status (live, refreshed every few seconds while in motion)
  • Rider GPS location (during out_for_delivery)
  • Event timeline — pickup, transit, delivery
  • Estimated delivery time
  • Rider's name and phone (when assigned)

No personal data (sender/receiver phone, payment info) is exposed publicly.

Sharing with your customer​

You have two options — they're not mutually exclusive.

Option A: We send the SMS​

When a shipment is confirmed, Dodo automatically sends an SMS to the receiver_phone you provided:

Your delivery is on its way.
Track here: https://dododelivery.co.tz/track?code=DODO7K9M2P4QR8

This happens for every shipment with no extra integration on your side. The receiver is gated through a one-tap sign-in/sign-up before the code resolves — turning every recipient into a registered Dodo customer for future receipts.

If you want to opt out of the automatic SMS for a particular merchant account, contact support.

Option B: You surface it in your own channels​

Use the tracking_code from your POST /merchant/shipments response in your own:

  • Order confirmation page
  • Email receipt
  • App push notification
  • WhatsApp / SMS broadcast

Build the URL with the format above. Test in sandbox first — sandbox tracking pages display a SANDBOX banner so end-users can't confuse them with real deliveries.

API tracking lookup​

There is no public API endpoint to look up shipment status by tracking code from your server — that's intentional. Use:

The public tracking page is for your end customer, not for backend correlation.

Example: hand-off in your order email​

<p>Hi Jane,</p>
<p>Your order is on the way. You can track it live here:</p>
<p>
  <a href="https://dododelivery.co.tz/track?code=DODO7K9M2P4QR8">
    Track delivery
  </a>
</p>