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