Track a booking

Endpoint

GET /api/bookings/v4/track/{id}

Returns tracking information for a confirmed booking, including the current status, timestamps, and depot details for each tracking event.

Authentication

Note

Requires authentication via API key or basic auth.

Path parameters

Parameter	Type	Required	Description
id	integer	Yes	The unique booking ID.

Example request

curl -X GET \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://www.transdirect.com.au/api/bookings/v4/track/12345678

Example response

{
  "id": 12345678,
  "status": 2,
  "tracking_events": [
    {
      "status": 1,
      "date": "2025-08-18",
      "time": "15:30",
      "depot": "Sydney"
    },
    {
      "status": 2,
      "date": "2025-08-19",
      "time": "06:00",
      "depot": "Melbourne"
    }
  ]
}

Tracking statuses

Status code	Status	Description
0	Not available	Tracking information is not yet available. The courier may not have scanned the parcel yet.
1	Picked up	The parcel has been collected from the sender.
2	In transit	The parcel is on its way to the destination.
3	Out for delivery	The parcel is on the delivery vehicle and will be delivered today.
4	Delivered	The parcel has been delivered to the receiver.
-1	Futile	A delivery attempt was made but was unsuccessful (e.g. no one available to receive).
-2	Check address	There is an issue with the delivery address. The courier needs clarification.
-3	Damaged	The parcel has been reported as damaged.

Response fields

Field	Type	Description
id	integer	The booking ID.
status	integer	Current overall tracking status code.
tracking_events	array	Array of tracking event objects, ordered chronologically.

Tracking event object

Field	Type	Description
status	integer	Tracking status code for this event.
date	string	Date of the event in YYYY-MM-DD format.
time	string	Time of the event in HH:MM format.
depot	string	Name of the depot or location where the event occurred.

Note

Tracking information is only available for bookings that have been confirmed by the courier. Bookings with a new, pending_payment, or demo status will not have tracking data.

Tip

Avoid polling for tracking updates more frequently than every 5 minutes. Courier tracking data is typically updated a few times per day, not in real time.

Handling negative statuses

Negative status codes indicate an issue with the delivery:

• Futile (-1) — The courier attempted delivery but could not complete it. A re-delivery will usually be attempted on the next business day.
• Check address (-2) — The delivery address may be incorrect or incomplete. Update the receiver details or contact support@transdirect.com.au.
• Damaged (-3) — The parcel has been reported as damaged during transit. Contact support@transdirect.com.au to lodge a claim.

Error responses

Status code	Description
401	Unauthorised — invalid or missing credentials.
404	Not found — no booking exists with the given ID, or it belongs to another member.