List bookings

Endpoint

GET /api/bookings/v4

Returns a list of bookings for the authenticated member, filtered by date and sorted in ascending or descending order.

Authentication

Query parameters

Parameter	Type	Required	Description
`since`	string	No	Return bookings created on or after this date. ISO 8601 format (e.g. `2025-08-01T00:00:00+1000`).
`sort`	string	No	Sort order: `"asc"` (oldest first) or `"desc"` (newest first). Defaults to `"desc"`.

Example request

curl -X GET \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  "https://www.transdirect.com.au/api/bookings/v4?since=2025-08-01T00:00:00%2B1000&sort=desc"

Example response

[
  {
    "id": 12345678,
    "status": "confirmed",
    "created_at": "2025-08-15T10:30:00+1000",
    "sender": {
      "postcode": "2000",
      "suburb": "SYDNEY",
      "type": "business",
      "country": "AU"
    },
    "receiver": {
      "postcode": "3000",
      "suburb": "MELBOURNE",
      "type": "business",
      "country": "AU"
    },
    "items": [
      {
        "weight": 5,
        "height": 25,
        "width": 35,
        "length": 40,
        "quantity": 1,
        "description": "carton"
      }
    ]
  },
  {
    "id": 12345677,
    "status": "new",
    "created_at": "2025-08-14T09:15:00+1000",
    "sender": {
      "postcode": "4000",
      "suburb": "BRISBANE",
      "type": "residential",
      "country": "AU"
    },
    "receiver": {
      "postcode": "5000",
      "suburb": "ADELAIDE",
      "type": "business",
      "country": "AU"
    },
    "items": [
      {
        "weight": 10,
        "height": 50,
        "width": 40,
        "length": 60,
        "quantity": 2,
        "description": "carton"
      }
    ]
  }
]

Response fields

Each booking object in the array contains:

Field	Type	Description
`id`	integer	Unique booking identifier.
`status`	string	Current booking status. See booking statuses.
`created_at`	string	Date and time the booking was created (ISO 8601).
`sender`	object	Sender location details.
`receiver`	object	Receiver location details.
`items`	array	Array of item objects in the booking.

Filtering by date

Use the since parameter to retrieve only recent bookings. This is useful for syncing bookings with your system without re-fetching your entire history.

# Get all bookings since 1 August 2025
curl -H "Api-key: YOUR_API_KEY" \
     "https://www.transdirect.com.au/api/bookings/v4?since=2025-08-01T00:00:00%2B1000"