---
title: "List customers"
method: GET
path: "/v1/customers"
tags: ["Customers"]
---

# List customers

`GET /v1/customers`

List all customers for your business. Requires a secret key (`sk_*`). Returns up to 100 customers sorted by creation date (newest first).

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'ACTIVE' | 'LOW_BALANCE' | 'PAUSED'
- `onchainAddress` string
- `isInternal` boolean

## Response `200`

List of customers

- object — List of customers
  - `data` object[]
    - `id` string, required — Internal customer ID
    - `businessId` string, required — Business ID this customer belongs to
    - `name` string, nullable — Customer display name
    - `externalCustomerId` string, nullable — Your system customer ID (null if created with onchainAddress only)
    - `stripeCustomerId` string, nullable — Stripe customer ID linked via Connect or migration
    - `onchainAddress` string, nullable — Smart account address (null for internal customers)
    - `email` string, email, nullable — End-customer email used for invoice receipt delivery (null if not set)
    - `isInternal` boolean, required — Internal customer (visibility only, no billing)
    - `status` 'ACTIVE' | 'LOW_BALANCE' | 'PAUSED', required — Customer status
    - `metadata` object, nullable — Arbitrary metadata attached to the customer
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `count` integer — Number of customers returned

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)