Tracking

Overview

Once a booking has been confirmed by the courier, you can track its progress through to delivery. Transdirect aggregates tracking information from courier partners into a common event-row shape, keyed by connote / item label.

Tracking via the API

curl -H "Api-key: YOUR_API_KEY" \
     https://www.transdirect.com.au/api/bookings/v4/track/BOOKING_ID

The response is an object keyed by connote (or item label). Each key maps to an array of event rows with fields such as date, status, description, location, and optionally track_status / pod_url. Full field details: track a booking.

Normalised stage codes

When an event includes a numeric track_status, it typically means:

Status code	Status	Description
`0`	Not available	Tracking information is not yet available.
`1`	Picked up	Collected from the sender.
`2`	In transit	On the way to the destination.
`3`	Out for delivery	On the delivery vehicle.
`4`	Delivered	Delivered to the receiver.
`-1`	Futile	Delivery attempt unsuccessful.
`-2`	Check address	Address issue — courier needs clarification.
`-3`	Damaged	Reported damaged.

Not every courier fills track_status on every row — use description / status for display when the code is missing.

Tracking via the dashboard

Members can track any booking from the Transdirect members area:

Log in to your account
Navigate to Bookings
Click on the booking you want to track
The tracking history is displayed on the booking detail page

Notifications

Booking API responses include a notifications object, but it is a stub: it always returns {"email": false, "sms": false} and cannot be used to configure tracking alerts via the REST API.

Receiver email notifications for delivery progress are managed through the members area / booking options where available — not by posting a notifications block on create/update.

Tracking in eCommerce plugins

If you’re using the WooCommerce or Shopify plugin with order sync enabled, tracking information is automatically updated in your store as the courier provides updates.