API Reference · Customers

List customers

Returns a cursor-paginated list of customers, newest first.

GET/v1/customers

Supports cursor pagination and an `email` filter for exact-match lookups.

Returnslist of customer objects

Query parameters

limitintegerdefault: 10

Max results.

Constraints: 1 <= limit <= 100

starting_afterstring

Cursor for the next page.

ending_beforestring

Cursor for the previous page.

emailstring

Filter to an exact email match.

Request

curl https://lunipay.io/api/v1/customers?email=ada@example.com \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
      "object": "customer",
      "livemode": false,
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "phone": "+18765551234",
      "company_name": "Analytical Engines Ltd.",
      "notes": "VIP — priority support",
      "metadata": {
        "internal_id": "ACCT-42"
      },
      "stripe_customer_id": "cus_Pxxxxxxxxxxxx",
      "created": 1713100800,
      "updated": 1713100800
    }
  ],
  "has_more": false
}