Public beta

Quotes

A quote gives you an upfront price and estimated delivery time before you commit to creating a delivery. Quotes are valid for 15 minutes from creation.

Create a quote

POST/v1/quotes

Request a delivery quote with upfront pricing and ETA.

Parameters

pickup_addressstringrequired

Full street address for the pickup location.

dropoff_addressstringrequired

Full street address for the dropoff location.

package_sizestringoptional

One of small, medium, or large. Defaults to small. Affects pricing and vehicle selection.

vehiclestringoptional

Preferred vehicle type: bike, car, or truck. If omitted, Zippex selects the best option based on package size and distance.

scheduled_atstringoptional

ISO 8601 timestamp to schedule the pickup. If omitted, the delivery is dispatched immediately. Must be at least 30 minutes in the future.

curl -X POST https:"color:#6a9955">//api.zippex.com/v1/quotes \
  -H "Authorization: Bearer zx_test_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "350 W Georgia St, Vancouver, BC V6B 6B1",
    "dropoff_address": "2085 Main St, Vancouver, BC V5T 3C3",
    "package_size": "medium",
    "vehicle": "car"
  }'

200 OK

{
  "id": "qt_r4s5t6u7",
  "fee": 1249,
  "currency": "cad",
  "eta_minutes": 35,
  "distance_km": 4.2,
  "vehicle": "car",
  "package_size": "medium",
  "pickup_address": "350 W Georgia St, Vancouver, BC V6B 6B1",
  "dropoff_address": "2085 Main St, Vancouver, BC V5T 3C3",
  "scheduled_at": null,
  "expires_at": "2026-03-10T14:15:00Z",
  "created_at": "2026-03-10T14:00:00Z"
}

Retrieve a quote

GET/v1/quotes/:quoteId

Retrieve a previously created quote to check its status and expiry.

Returns a previously created quote. Useful for checking whether a quote is still valid before creating a delivery.

quoteIdstringrequired

The quote ID (path parameter).

curl https:"color:#6a9955">//api.zippex.com/v1/quotes/qt_r4s5t6u7 \
  -H "Authorization: Bearer zx_test_abc123def456"

200 OK

{
  "id": "qt_r4s5t6u7",
  "fee": 1249,
  "currency": "cad",
  "eta_minutes": 35,
  "distance_km": 4.2,
  "vehicle": "car",
  "package_size": "medium",
  "pickup_address": "350 W Georgia St, Vancouver, BC V6B 6B1",
  "dropoff_address": "2085 Main St, Vancouver, BC V5T 3C3",
  "scheduled_at": null,
  "expires_at": "2026-03-10T14:15:00Z",
  "created_at": "2026-03-10T14:00:00Z"
}

Quote expiry

Quotes expire 15 minutes after creation. Attempting to create a delivery with an expired quote returns a 410 Gone error:

410 Gone

{
  "error": {
    "type": "invalid_request_error",
    "code": "quote_expired",
    "message": "Quote qt_r4s5t6u7 has expired. Please request a new quote.",
    "param": "quote_id"
  }
}

Tip

Check the expires_at timestamp before using a quote. If it is close to expiring, request a fresh quote to avoid errors.

Scheduled deliveries

Pass scheduled_at to get a quote for a future pickup time. The timestamp must be at least 30 minutes in the future and no more than 7 days ahead.

curl -X POST https:"color:#6a9955">//api.zippex.com/v1/quotes \
  -H "Authorization: Bearer zx_test_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "350 W Georgia St, Vancouver, BC V6B 6B1",
    "dropoff_address": "2085 Main St, Vancouver, BC V5T 3C3",
    "scheduled_at": "2026-03-11T09:00:00Z"
  }'

Pricing details

Delivery fees are calculated based on distance, duration, and vehicle type. The quote gives you the exact price upfront — see Pricing for a full breakdown.