Module guide

Booking API course

Build your own online booking screens for dumpsters and junk removal on the Dumpster Controls engine: every call, every field, every error, with working code.

The Booking API lets a dumpster rental or junk removal company run fully custom booking screens on its own website while Dumpster Controls prices the order, runs every rule, screens the payment and creates the order on the dispatch board.

This module is the complete course: concepts, keys and domains, the read endpoints, quotes, the order with card payment, junk removal, webhooks, errors, security, working examples and a go-live checklist. It is written so that a developer, or an AI coding tool, can build a working integration in one sitting.

Everything here is included free on every plan, with no approval. Base URL: https://gcwyoiihrupbfqqlcurh.supabase.co/functions/v1/booking-api/v1. Spec: https://dumpstercontrols.io/openapi-booking.json. Reference pages: https://dumpstercontrols.io/developers/booking and https://dumpstercontrols.io/developers/booking/api.

Step-by-step guides

• Lesson 1: what the Booking API is and how the pieces fit
• Lesson 2: keys, allowed domains and authentication
• Lesson 3: GET /company and GET /sizes, the data your screens start from
• Lesson 4: GET /availability, closed days and the service area
• Lesson 5: POST /check and POST /quote, validate and price before the card
• Lesson 6: POST /intents, the server prices the order and opens the payment
• Lesson 7: take the card with Stripe.js on your page
• Lesson 8: POST /confirm and GET /sessions, create the order and never lose one
• Lesson 9: junk removal with the Booking API (/junk/*)
• Lesson 10: webhooks and signature verification
• Lesson 11: errors, limits, idempotency and the security model
• Lesson 12: a complete example in plain JavaScript
• Lesson 13: React, Next.js and AI builders (Claude, Lovable, Codex)
• Lesson 14: go-live checklist and what to tell the office
• Lesson 15: materials, the price depends on what goes in

Frequently asked questions

Do I need approval or a paid plan to use the Booking API?

No. Every active company has its keys in Online Booking, Developers. There is no request, no review and no usage window. The limit is 120 requests per minute per key and per IP.

Can the API change prices, refund or cancel?

No. Money moves only from the customer to the company. Prices, dates, promo codes and fraud screening are decided on the server; refunds, cancellations and price changes stay in the app and in the approval-gated data API.

Does the order created by the API look different in the app?

No. It is created by the same function as the hosted page and the widget: customer, invoice, payment record, confirmations and the dispatch board entry are identical. Only the channel recorded on the order says api.

Is there a sandbox?

Not yet. Quotes and checks cost nothing. For a real end-to-end test, book a 10 dollar order on your own company with a real card and refund it from Order History.

© 2026 Dumpster Controls. All rights reserved. Made in the USA.