Skip to content

Release a booking for collection

POST /api/v5/bookings/{id}/ready-for-collection

A booking confirmed with defer_pickup: true is paid but held back from the courier. Call this when the goods are ready. The pickup moves to the courier’s next business day after today, skipping weekends and public holidays in the sender’s state, and the booking is sent to the courier. The pickup window you booked is kept when the courier still accepts it on that day; otherwise the courier’s standard window is used.

Deferred pickup is switched on per account, and only TNT Road Express, Xpress, Aramex, Hunter Road Freight and Couriers Please bookings can be held. Contact Transdirect to switch it on.

ParameterTypeRequiredDescription
idintegerYesThe unique booking ID.

No request body is needed.

Terminal window
curl -X POST \
-H "Api-key: YOUR_API_KEY" \
https://api.transdirect.com.au/api/v5/bookings/12345678/ready-for-collection

200 with the new pickup:

{
"success": true,
"released": true,
"pickup_date": "2026-11-23",
"pickup_time": "09:00-17:00",
"message": "Released for collection on Monday 23 November."
}

Calling it again for a booking that is already released is safe: it returns 200 with released: false and the booking’s current pickup, and changes nothing.

StatusBodyCause
401{"error":"missing_api_key"} or {"error":"invalid_api_key"}No key, or a key that is not active.
404{"error":"booking_not_found"}No booking with that id belongs to your account.
409{"errors":["This booking is not held for collection."]}The booking was not confirmed with defer_pickup.
409{"errors":["This booking can no longer be released for collection."]}The booking was cancelled or has already been sent to the courier.
409{"errors":["No pickup date is available for this courier. Contact support."]}The courier offers no pickup date after today.
409{"errors":["This booking is already being released. Try again in a moment."]}Another release of the same booking is still running.