Dumpster Controls · agent page

This is the agent-optimized version of https://dumpstercontrols.io/help/api/customers-endpoint: the same content as the human page, without scripts, styles, animations or navigation. People should open the full page.

Canonical page
https://dumpstercontrols.io/help/api/customers-endpoint
Last updated
2026-08-22
Tokens
600 tokens (cl100k_base), within the 2,500-token budget for a help page
Size
6.2 KB for this page, against 20 KB for the human page (69% smaller)
Markdown
https://dumpstercontrols.io/help/api/customers-endpoint.md, or send Accept: text/markdown to the canonical URL
Cite as
Customers endpoint. Dumpster Controls. https://dumpstercontrols.io/help/api/customers-endpoint (accessed 2026-11-16).
More for agents
Facts sheet · llms.txt · llms-full.txt · All agent pages · Product manual

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

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