Skip to main content
GET
/
api
/
v1
/
customers
JavaScript
import Stigg from '@stigg/typescript';

const client = new Stigg({
  apiKey: process.env['STIGG_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const customerListResponse of client.v1.customers.list()) {
  console.log(customerListResponse.id);
}
{
  "data": [
    {
      "createdAt": "2026-12-09T01:44:41.821Z",
      "updatedAt": "2026-12-09T01:44:41.824Z",
      "archivedAt": "2026-12-09T01:44:41.826Z",
      "name": "John Doe",
      "email": "[email protected]",
      "id": "customer-6e24b4",
      "metadata": {},
      "integrations": [],
      "defaultPaymentMethod": {
        "type": "CARD",
        "billingId": "pm_1Q0PsIJvEtkwdCNYMSaVuRz6",
        "cardLast4Digits": "1234",
        "cardExpiryMonth": 12,
        "cardExpiryYear": 2025
      },
      "couponId": "coupon-6e24b4",
      "cursorId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

Authorizations

X-API-KEY
string
header
required

Server API Key

Headers

X-API-KEY
string
required

Server API Key

Query Parameters

after
string<uuid>

Return items that come after this cursor

before
string<uuid>

Return items that come before this cursor

limit
integer
default:20

Maximum number of items to return

Required range: 1 <= x <= 100

Response

OK

Response list object

data
Customer · object[]
required
pagination
object
required

Pagination metadata including cursors for navigating through results