Skip to main content

Parcel limits, prohibited items, liability and the merchant filter

Reeds Engineering
Reeds Engineering
Developer platform

What Reeds carries is now part of the contract, and platforms can filter by merchant.

New error codes (422)​

  • PARCEL_TOO_HEAVY: package.weight_kg over 30 kg.
  • PARCEL_TOO_LARGE: the longest side in the new, optional package.dimensions_cm (length, width, height, in centimetres) over 120 cm.
  • PROHIBITED_ITEM: the description names something Reeds can't carry (cash, weapons, drugs, hazardous goods such as petrol or gas cylinders, perishable food). The message names the category.
  • SHIPPER_REQUIRED: a platform account created a delivery without shipper.

Liability​

Every delivery now has liability: { covered_amount, cap } (kobo): what Reeds covers if the parcel is lost or damaged, which is the declared value up to ₦50,000. A higher declared_value is still accepted.

Merchants​

GET /deliveries takes merchant_id: platform accounts get only that merchant's deliveries (shipper.merchant_id).

Nothing is removed or renamed. Clients that ignore unknown fields need no change.