Skip to main content

Parcels Delivery

Manage parcel delivery operations.

Overview​

The Parcels API handles:

  • Creating delivery requests
  • Tracking delivery status
  • Managing rider assignments
  • Calculating delivery costs

Endpoints​

Search Parcel Transportation Offers​

POST /parcel/search-offers

Returns customer-selectable parcel transportation offers for a pickup and drop-off request. The endpoint can quote freelance rider journeys, transportation-company journeys, or stitched journeys that combine first-mile, middle-mile, and last-mile segments.

Use this before creating a customer parcel delivery request. The selected offer becomes the source of truth for checkout, pricing, route segments, and downstream delivery workflows.

Developer Notes​

The offer search endpoint is implemented by searchParcelTransportationOffers in src/controller/parcel/index.ts and uses helper logic from src/controller/parcel/utils.ts and src/utils/parcel.ts.

It also calls child parcel-trip APIs internally when transportation-company modes are supported:

  • POST /api/parcel-trip/flight
  • POST /api/parcel-trip/intercity
  • POST /api/parcel-trip/cargo