---
title: "Customers endpoint | Dumpster Controls"
url: "https://dumpstercontrols.io/help/api/customers-endpoint"
description: "GET /v1/customers returns your customer database, paginated, with the fields a CRM sync needs and nothing it should not have."
date_modified: "2026-08-22"
type: help
tokens: 1023
token_budget: 2000
format: markdown for AI agents, generated at build from the same content as the HTML page
---

Developer API · updated 2026-08-22

# Customers endpoint

GET /v1/customers returns your customer database, paginated, with the fields a CRM sync needs and nothing it should not have.

1. ## List customers
  ```
  GET /v1/customers with page and per_page (max 100), newest first:
  ```
  curl -H "Authorization: Bearer dc_live_..." \
  "https://gcwyoiihrupbfqqlcurh.supabase.co/functions/v1/api-v1/v1/customers?per_page=100"
  ```
2. ## The customer object
  id (use it to match customer_ref on orders and junk jobs), first_name, last_name, company_name, email, phone, customer_type, address_line1, city, state, zip_code, total_orders, lifetime_value (dollars), is_active and created_at.
3. ## What is intentionally NOT exposed
  SMS consent and opt-out records, internal notes, and structured segment data stay private. Consent state lives with us so YOUR marketing tools never act on stale consent by accident: message customers through Dumpster Controls, which enforces opt-outs automatically.
4. ## CRM sync recipe
  Daily job inside your free window (or anytime on paid): pull /v1/customers pages, upsert into your CRM keyed by the id field, and pull /v1/orders?from=YESTERDAY to attach recent activity. Combine with the order.created webhook so new business appears in the CRM in real time between syncs.

## Related guides

- [Orders endpoints: list and read orders](https://dumpstercontrols.io/help/api/orders-endpoints)
- [Receive real-time webhooks](https://dumpstercontrols.io/help/api/receive-real-time-webhooks)

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

## 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.

---

Source: https://dumpstercontrols.io/help/api/customers-endpoint (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 .