univoozAPI
API referenceOrders

Preview an order

POST /v1/orders/quote — see the times and the fleet, and create nothing.

POST/v1/orders/quoteAdvanced plan

Needs a plan with features_advancedApi. On Standard this gives 403 feature_not_available.

Request

The same form as Create an order. Univooz ignores externalOrderId.

Response

{
  "fleet": { "name": "Copenhagen Couriers" },
  "zone": { "code": "CZ-K7M2PQR4", "name": "Central Zone" },
  "distance": 3.4,
  "schedule": {
    "mode": "asap",
    "resolved": {
      "pickupTime": "2026-07-29T12:20:00.000Z",
      "deliveryTime": "2026-07-29T12:50:00.000Z",
      "basis": "busy_hours"
    }
  }
}

distance is in kilometres, with two decimals.

This endpoint gives no price. Univooz does not price deliveries.

Errors

The same as Create an order, with two differences: there is no 409, and a Standard plan gives 403 feature_not_available.

Notes

  • Univooz stores nothing — no customer, no address, no order, no charge. This is also true for a rejected preview.
  • The times are the order's times. Univooz uses the same routing and the same calculation. Send the same body to POST /v1/orders and you get these times.
  • A preview is correct while its conditions are correct. A change to a zone, or a full driver list, changes the next answer.
  • Searches cost one time. A stored address or your coordinates cost nothing. All other addresses need one search, and Univooz keeps the result, so a preview and then an order pay one time.
  • A test key and a live key give the same answer.

On this page