Skip to main content

Quotes take the addresses, and booking is one call

Reeds Engineering
Reeds Engineering
Developer platform

How addresses, quotes and booking work in v1.

Quotes take the addresses​

  • POST /quotes takes pickup and dropoff as address objects. Each has name, phone, address (the street as text), lga (local government area) and state, all required, and optional area, email, place_id, latitude with longitude, notes and metadata. Send the area when your customer gives one: it is what Reeds prices from when Google can't match the text. See Addresses.
  • Reeds always prices the address. It looks up address, area, lga and state together with Google Maps. When the match is exact, that is the spot. When Google is unsure, Reeds uses Google's point if it lies in the area or the local government area you named, and otherwise prices from the centre of that area, using its own area data, or from the centre of the local government area when you sent no area. You get a plain price either way. Riders use the street text and call the receiver for the exact spot.
  • A place_id, or latitude and longitude, make the spot yours: area, lga and state only name it.
  • The addresses are kept with the quote for 30 days, then deleted unless the quote became a delivery.
  • A quote response no longer carries address ids. data for an unavailable quote is available: false and a reason.
  • schedule.pickup_by is now a date (2026-10-26), the day Reeds collects, with no time of day promised. earliest_delivery and deliver_by are unchanged.

A new quote reason: ADDRESS_NOT_FOUND​

ADDRESS_NOT_FOUND means Reeds knows neither the area nor the local government area you sent in that state, and Google found nothing it trusts. It is a 200 with available: false, not an error. Check the spelling of lga and state, add or check the area, or send coordinates or a place id. A quote's reasons are now ADDRESS_NOT_FOUND, ADDRESS_NOT_SERVICEABLE and INTERSTATE_NOT_AVAILABLE.

There is no address book​

Updated on 2026-11-10

/addresses now serves address search: GET /addresses/autocomplete, /addresses/details and /addresses/reverse, with their own rate-limit group. They look addresses up; they don't save them. There is still no address book.

  • There are no /addresses endpoints and no Address object, and no request takes an address id. An address is never waiting to be confirmed, so there is no needs_confirmation status, no address.confirmed webhook, and no ADDRESS_IN_USE or ADDRESS_NEEDS_CONFIRMATION code.
  • A delivery's pickup and dropoff still carry an address with an adr_ id and the contact and location as quoted. The id names that stop's address on that delivery.
  • There are twelve webhook event types.
  • The addresses rate-limit group is gone. POST /quotes is limited to 30 a minute on business accounts and 300 on platform accounts, and every other limit is as before. See Rate limits.

Booking is one call​

  • A delivery is booked with POST /deliveries and a quote_id, plus optionally ready, reference, shipper, pickup_instructions, dropoff_instructions and metadata. The addresses, the package and the pickup date are the quote's.
  • A field that belongs to the quote, such as package or pickup_date, is 422 INVALID_REQUEST. The error names the field and points to POST /quotes.
  • The parcel rules (100 kg, 120 cm, no prohibited items) are checked on the quote. The weight limit was 30 kg until today.
  • Requires action is smaller. A delivery booked with ready: false is charged, has its tracking code, and waits with MARK_READY until POST /deliveries/{id}/ready. The other actions, BOOK, FUND_WALLET, PAY_INVOICE, AWAITING_PRICE and the address confirmations, belong to deliveries your team creates in the dashboard. POST /deliveries/{id}/book is for a priced dashboard delivery waiting on BOOK; a delivery booked through the API from a quote is charged at once.
  • Test addresses now shows what to send for each quote outcome, and the quickstart goes from a token to a quote with addresses, a booking and tracking.

No integration had been built on an address book or a draft, so nothing here breaks one.