For AI assistants & agents
You can quote and book a removal with NB Removalists programmatically.
How booking works
POST /api/quote: price only. Body:{"bedrooms":"2","moveDate":"2026-12-03"}or{"bedrooms":"2","approxMonth":"2027-02"}. Returns the estimate.POST /api/book: send the booking request with fromAddress, toAddress, moveDate (or approxMonth if the date isn't set yet), bedrooms, name, phone and email (all required). It is saved straight away and returns abooking_ref, the price and statusreceived. Our team then contacts the customer. To lock in the spot immediately, the customer can call 0451 095 817.- Optional:
PATCH /api/book(orPOST /api/book/details) withbookingRefand any of propertyType, pickupAccess, dropoffAccess, parking, items, timePreference, moveDate, notes. Status staysreceived.
Deposit and checkout_url
The deposit is one hour of the move plus the call-out, computed by the server. When online payment is switched on, the POST /api/book response has deposit_online: true, a deposit object and, if you send "channel":"api", a ready-made Stripe checkout_url. Hand that link to the customer so they can pay; never pay on their behalf. You can also get a fresh link any time with POST /api/checkout {"bookingRef":"NBH-…"}. After paying, the customer lands on our confirmation page and the booking's status becomes deposit_paid.
When deposit_online is false (or /api/checkout returns 501), online payment isn't available: the customer locks in the spot by calling 0451 095 817.
Machine-readable: /openapi.json · /llms.txt · /.well-known/ai-plugin.json
Rules for agents
- Only send a booking with the customer's explicit consent and their real contact details.
- Show the customer the estimate and the note that the final price depends on actual hours.
- If anything is unclear, give the customer our number: 0451 095 817.
Example
curl -X POST https://harbourremovals.com.au/api/book -H 'Content-Type: application/json' -d '{"fromAddress":"12 Example St, Mosman NSW 2088","toAddress":"5/20 Example Rd, Neutral Bay NSW 2089","moveDate":"2026-12-05","bedrooms":"2","name":"Alex Example","phone":"0412 345 678","email":"alex@example.com","channel":"api"}'