Skip to main content
GET
/
api
/
canary
/
customers
List Customers
curl --request GET \
  --url http://localhost:3000/api/canary/customers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "customer_789",
      "merchantId": "merchant_456",
      "email": "[email protected]",
      "name": "John Doe",
      "metadata": {
        "source": "web",
        "referralCode": "FRIEND123"
      },
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 150,
    "hasMore": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

merchantId
string
required

The ID of the merchant. This parameter is required.

limit
number

Maximum number of records to return

offset
number

Number of records to skip

Response

Successfully retrieved customers list

data
object[]
required
pagination
object
required