--- title: "Booking API course: 15 How-To Guides | Dumpster Controls" url: "https://dumpstercontrols.io/help/booking-api" description: "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." type: help tokens: 1297 token_budget: 2000 format: markdown for AI agents, generated at build from the same content as the HTML page --- 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](https://dumpstercontrols.io/help/booking-api/lesson-1-what-the-booking-api-is-and-how-the-pieces-fit) - [Lesson 2: keys, allowed domains and authentication](https://dumpstercontrols.io/help/booking-api/lesson-2-keys-domains-and-authentication) - [Lesson 3: GET /company and GET /sizes, the data your screens start from](https://dumpstercontrols.io/help/booking-api/lesson-3-company-profile-and-sizes-with-live-prices) - [Lesson 4: GET /availability, closed days and the service area](https://dumpstercontrols.io/help/booking-api/lesson-4-availability-closed-days-and-the-service-area) - [Lesson 5: POST /check and POST /quote, validate and price before the card](https://dumpstercontrols.io/help/booking-api/lesson-5-check-and-quote-before-the-card) - [Lesson 6: POST /intents, the server prices the order and opens the payment](https://dumpstercontrols.io/help/booking-api/lesson-6-start-the-order-with-post-intents) - [Lesson 7: take the card with Stripe.js on your page](https://dumpstercontrols.io/help/booking-api/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](https://dumpstercontrols.io/help/booking-api/lesson-8-confirm-the-order-and-recover-with-sessions) - [Lesson 9: junk removal with the Booking API (/junk/*)](https://dumpstercontrols.io/help/booking-api/lesson-9-junk-removal-with-the-booking-api) - [Lesson 10: webhooks and signature verification](https://dumpstercontrols.io/help/booking-api/lesson-10-webhooks-and-signature-verification) - [Lesson 11: errors, limits, idempotency and the security model](https://dumpstercontrols.io/help/booking-api/lesson-11-errors-limits-idempotency-and-security) - [Lesson 12: a complete example in plain JavaScript](https://dumpstercontrols.io/help/booking-api/lesson-12-complete-example-in-plain-javascript) - [Lesson 13: React, Next.js and AI builders (Claude, Lovable, Codex)](https://dumpstercontrols.io/help/booking-api/lesson-13-react-next-js-and-ai-builders) - [Lesson 14: go-live checklist and what to tell the office](https://dumpstercontrols.io/help/booking-api/lesson-14-go-live-checklist) - [Lesson 15: materials, the price depends on what goes in](https://dumpstercontrols.io/help/booking-api/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. --- Source: https://dumpstercontrols.io/help/booking-api (human version of this page). Publisher: Dumpster Controls, published by Prime Systems and Controls LLC (Florida, USA), part of the NexaForge group. Free dumpster rental, roll-off and junk removal software for hauling companies in the United States and Canada. Facts for AI assistants: https://dumpstercontrols.io/ai . Site index for agents: https://dumpstercontrols.io/llms.txt . Product manual: https://dumpstercontrols.io/help .