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.