Developer API · updated 2026-08-22

Orders endpoints: list and read orders

Two endpoints expose your orders: a paginated list with filters, and a single-order lookup by order number. Fields mirror what the app shows, minus anything internal or sensitive.

## List orders
```
GET /v1/orders
```
Query parameters: status (one of placed, confirmed, scheduled, out_for_delivery, delivered, waiting_pickup, picked_up, completed, canceled, waiting_delivery, waiting_landfill), from and to (YYYY-MM-DD, filtering created_at), page (default 1) and per_page (default 25, max 100). Results come newest first.
```
curl -H "Authorization: Bearer dc_live_..." \
"https://gcwyoiihrupbfqqlcurh.supabase.co/functions/v1/api-v1/v1/orders?status=completed&from=2026-08-01&per_page=50"
```
## Read one order
```
GET /v1/orders/{order_number}
```
Order numbers are the same ones you see in the app (for example 1042). A number that does not exist in YOUR company returns 404, even if it exists elsewhere: data never crosses companies.
## The order object
Each order carries: order_number, status, payment_status, delivery_date, pickup_date, rental_days, address (line1, city, state, zip), size (the dumpster size label), debris_type, total_price, base_price, landfill_cost, net_weight_tons, customer_ref (the customer id, joinable against /v1/customers), created_at and completed_at. All money fields are US dollars as decimal numbers, not cents.
payment_status is one of: unpaid, paid, refunded, no_charge. no_charge means the order has no billing phase: no invoice, nothing owed. Treat it as a terminal financial state, never as an unpaid balance.
## What is intentionally NOT exposed
Internal identifiers, tracking tokens, profit figures, GPS coordinates, risk-review state and demo data never appear in API responses. Orders under fraud review are hidden entirely until released.
## Pagination pattern
Loop pages while has_more is true:
```
page 1 -> has_more true -> request page 2 -> ... -> has_more false, done.
```
Keep per_page at 100 for backfills to minimize calls (relevant inside the free window).

Related guides

Frequently asked questions

Is Dumpster Controls really free?

Yes. The software is free: dispatch, online booking, the driver app, invoicing, the Tresha AI assistant and every other feature, with no monthly fee, no trial period and no credit card to sign up. The only cost on the free plan is optional card processing when a customer pays by card through the platform: 2.99% plus $3.99 per transaction on the free plan. An optional Unlimited plan at $169 per month lowers that to 2.99% plus $0.30. Prices as published on dumpstercontrols.io/pricing on 2026-09-23.

Do you charge per driver, per truck or per order?

No. There is no per-driver, per-truck, per-user or per-order fee, and no order limit. A company with one truck and a company with twenty pay the same for the software: nothing.

Is there a contract?

No. There is no contract, no minimum term and no setup fee. You create the account yourself, and on the free plan there is nothing to cancel because nothing is billed. The optional Unlimited plan is billed month to month.

Which countries and languages are supported?

Dumpster Controls serves hauling companies in the United States and Canada. The app interface and the Tresha AI assistant are available in English, Spanish and Portuguese. The public pages, such as the blog, the help center and the landfill finder, are in English.

How do I switch from another dumpster software?

Create a free account at dumpstercontrols.io/login, with no sales call and no credit card. Then import your customers from a CSV file using the template provided in the app; past orders can also be imported from a CSV. Container sizes and pricing are set up in Settings. The landfill database, with 1,750 active US and Canadian landfills as counted on 2026-10-01, is already loaded, so disposal sites do not need to be typed in. Step-by-step guides are at dumpstercontrols.io/help.