Skip to content

Delivery methods

delivery_method states the most preferred way to deliver the parcel. When the parcel doesn’t fit that tier, E-Parcel may fall back down the chain, but never to a tier you ruled out.

You send Can be delivered as
(omitted) Any tier, best fit
HOME Letterbox or to the door, otherwise locker or pickup
HOME_MAILBOX Letterbox, otherwise locker or pickup. Never to the door.
HOME_DOOR To the door, otherwise locker or pickup. Never letterbox.
LOCKER Parcel locker, otherwise pickup point
PICKUP Pickup point only

The tier that was actually used is returned as delivery_type by GET /api/v1/shipments/{shipment_id}.

There is no field to choose a specific locker. The carrier allocates the locker that serves the recipient’s postal code and notifies the recipient, which is why both recipient_email and recipient_phone are required.

These limits are configured on the server and may change, so the API’s answer is always authoritative:

Tier Roughly fits
Letterbox (HOME_MAILBOX) Up to 2 kg and 3 × 25 × 35 cm
To the door (HOME_DOOR) Up to about 4–5 kg, mid-size boxes
Parcel locker (LOCKER) Up to 25 kg
Heavier than 25 kg No route: 422

Dimensions are matched in any orientation, so the order of length_mm, width_mm and height_mm does not matter.

When no tier you allow fits the parcel, the API answers 422 with "detail": "no routing rule matched this parcel" and stores nothing. Broaden delivery_method, or send the parcel to a human queue.