Order an Economy Delivery
Economy deliveries start at a Zippd hub. When you place an order, provide the recipient’s details and the items to deliver. Zippd selects the Economy hub that serves the delivery postcode.
Check coverage
- List Economy hubs with Get all serviceable hubs and set
service_type=economy. - Look up a hub’s postcodes with Get serviceable postcodes for a hub. Pass the hub’s
idashub_idand setservice_type=economy.
Both lookups return paginated results and default to non_dedicated when service_type is omitted. An Economy hub ID requires service_type=economy on the postcode lookup.
Place an order
Send a POST request to Create an Economy order with exactly one delivery location in order_locations. Include the full delivery address, recipient contact details, payment method and at least one item. Use barcode_generation.packages to generate labels when you place the order.
A successful request returns 201 Created. Use the UUID in data.id to retrieve the order. The response includes the hub as the collection location and the recipient’s address as the delivery location.
The order awaits parcel scans at the hub. Once all parcels have been scanned, delivery is scheduled based on the hub scan time and the configured delivery cut-off. Economy orders skip the ready-for-collection step.
Authentication and validation
Send your bearer token with each request. The API returns 401 Unauthorized when authentication fails and 403 Forbidden when the authenticated user does not have API access.
The API returns 422 Unprocessable Entity if the request is invalid. For example, a booking can return a validation error if there is no Economy hub for the delivery postcode. A postcode lookup returns a validation error if the hub ID does not match the selected service.
