Skip to main content
POST /v1/org/quote/getQuote
Send an origin, destination, items, and the customer(s) to quote for. The response returns shared origin / destination / goods, plus one results entry per customer with its priced quotes.

​
Authorization

​
x-api-key
string
required
Your organisation API key (dzk_live_…). See Authentication.

​
Body

​
general
object
required
​
origin
object
required
Pickup location. Only postalCode is required; the rest is enriched server-side.
​
destination
object
required
Delivery location. Same fields as origin (with postalCode required).
​
items
object[]
required
Goods to quote. At least one item.
​
filters
object
Optional. Narrow which services / rate cards are priced. Empty or omitted = no restriction. See Filters.

​
Response

​
origin
object
Enriched pickup location echoed back.
​
destination
object
Enriched delivery location echoed back.
​
goods
object[]
The items, with computed chargeableWeight.
​
results
object[]
One entry per requested customer.
curl https://api.dyspach.com/v1/org/quote/getQuote \
  -H "x-api-key: $DYSPACH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "general": { "customerIds": ["ACME"] },
    "origin": { "postalCode": "2000", "countryCode": "AU" },
    "destination": { "postalCode": "3000", "countryCode": "AU" },
    "items": [
      { "type": "Carton/Box", "quantity": 2, "length": 0.3, "width": 0.3, "height": 0.3, "weight": 10 }
    ],
    "filters": { "serviceIds": ["ZEPHYR", "FALCON"] }
  }'

{
  "origin": { "postalCode": "2000", "suburb": "BARANGAROO", "city": "Sydney", "state": "NSW", "stateName": "New South Wales", "countryCode": "AU" },
  "destination": { "postalCode": "3000", "suburb": "MELBOURNE", "city": "Melbourne", "state": "VIC", "stateName": "Victoria", "countryCode": "AU" },
  "goods": [
    { "type": "Carton/Box", "quantity": 2, "length": 30, "width": 30, "height": 30, "weight": 10, "chargeableWeight": 20 }
  ],
  "results": [
    {
      "customerId": "ACME",
      "quoteId": "K541037RNBUQ",
      "noQuoteMessage": "",
      "quotes": [
        {
          "rateId": "7cd6c7cf-84af-419d-b34d-6d270cc809ee",
          "serviceName": "Falcon Freight",
          "serviceId": "FALCON",
          "rateCardName": "Falcon Standard",
          "rateCardId": "FALCON_STD",
          "isSpotRate": false,
          "spotRateMessage": "",
          "amount": 10,
          "totalAmount": 19.8,
          "gstAmount": 1.8,
          "deliveryTime": "1 - 5 business day(s)",
          "minTransitTime": 1,
          "maxTransitTime": 5,
          "transitTimeUnit": "D",
          "surcharges": [
            { "name": "Remote Location", "description": "Remote Location", "key": "Remote Location", "amount": 8 }
          ]
        },
        {
          "rateId": "ba9bc08c-0238-4c88-aff5-b4f26aaab790",
          "serviceName": "Zephyr Couriers",
          "serviceId": "ZEPHYR",
          "rateCardName": "Zephyr Express",
          "rateCardId": "ZEPHYR_EXP",
          "isSpotRate": false,
          "spotRateMessage": "",
          "amount": 9,
          "totalAmount": 11.09,
          "gstAmount": 1.01,
          "deliveryTime": "0 - 0 business day(s)",
          "minTransitTime": 0,
          "maxTransitTime": 0,
          "transitTimeUnit": "D",
          "surcharges": [
            { "name": "Fuel Surcharge", "description": "Fuel Surcharge", "key": "FUEL", "amount": 1.08 }
          ]
        }
      ]
    }
  ]
}