> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api-docs.zippd.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.zippd.com/_mcp/server.

# 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

1. List Economy hubs with [Get all serviceable hubs](https://api-docs.zippd.com/serviceable-hubs/get-serviceable-hubs) and set `service_type=economy`.
2. Look up a hub's postcodes with [Get serviceable postcodes for a hub](https://api-docs.zippd.com/serviceable-hubs/get-serviceable-postcodes). Pass the hub's `id` as `hub_id` and set `service_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](https://api-docs.zippd.com/orders-economy/post-orders-economy) 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](https://api-docs.zippd.com/orders/get-orders-order-id). 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.