List customers

GET/v1/customers

Key scope: read

Lists customers, newest first, or finds one by your externalId.

Query parameters

externalId string: Exact match; answers a list of zero or one.
createdBefore ISO time: Page backwards from this time.
limit integer: 1–100, default 50.

Errors

401 api_key_required
401 api_key_invalid
401 api_key_wrong_mode
403 scope_missing
429 rate_limited

All codes: Errors.

Request

curl "https://wallet.simpleeasytransactions.com/v1/customers" \
  -H "Authorization: Bearer $SET_API_KEY"

Response 200

{
  "object": "list",
  "data": [ {
      "id": "cus_4f0c6e2a9b1d4c7e8f3a5b6c7d8e9f01",
      "object": "customer",
      "externalId": "merchant-1042",
      "type": "business",
      "status": "approved",
      "tosLink": null,
      "kycLink": null,
      "requirementsDue": [],
      "rejectionReasons": [],
      "endorsements": { "base": "approved", "sepa": "missing", "faster_payments": "missing" },
      "currencies": ["usd"],
      "livemode": true,
      "createdAt": "2026-11-08T15:04:05.000Z",
      "updatedAt": "2026-11-08T15:04:05.000Z"
    } ],
  "hasMore": false
}