Skip to content

Create a quote

Endpoint

POST /api/quotes

Creates a draft booking (status: new) and returns courier quotes — the same underlying record model as POST /api/bookings/v4.

Authentication

Requires authentication via API key or basic auth.

Request body

Same core shape as create a booking:

Field	Type	Required	Description
`items`	array	Yes	At least one item with weight, dimensions (cm), quantity, and packaging `description`.
`sender`	object	Yes	At minimum `postcode`, `suburb`, `type`, `country`.
`receiver`	object	Yes	At minimum `postcode`, `suburb`, `type`, `country`.
`declared_value`	string \| number	No	Declared value (AUD) for warranty.
`include_warranty`	boolean	No	Set `false` to opt out of warranty.
`tailgate_pickup` / `tailgate_delivery`	boolean	No	Tailgate flags.

description on the booking body is accepted as an alias for goods description (goods_description).

Example

curl -X POST \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "weight": 5,
        "height": 25,
        "width": 35,
        "length": 40,
        "quantity": 1,
        "description": "Carton"
      }
    ],
    "sender": {
      "postcode": "2000",
      "suburb": "SYDNEY",
      "type": "business",
      "country": "AU"
    },
    "receiver": {
      "postcode": "3000",
      "suburb": "MELBOURNE",
      "type": "business",
      "country": "AU"
    }
  }' \
  https://www.transdirect.com.au/api/quotes

Response

Returns 201 with a booking/quote object including id, status (new), quotes keyed by courier string_id, and usually quote_errors. Shape matches create a booking.