List Customers

​

Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.

You can also create and manage customers in the Merchant Dashboard.

Related guide: Dashboard Tour - Customers

Query Parameters
  • limit
    Type: integer

    Integer numbers.

  • last_key
    Type: string

    Opaque cursor for pagination. Use the last_key value from the previous response to retrieve the next page.

  • id
    Type: array string[]

    Filter customers by one or more customer ids.

  • email
    Type: string

    Filter customers by exact email address.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/customers
curl https://api.paypercut.io/v1/customers \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "created": "2026-07-08T08:02:27.783Z",
      "livemode": true,
      "email": null,
      "name": null,
      "phone": null,
      "preferred_locales": [
        "string"
      ],
      "address": {
        "city": null,
        "country": null,
        "line1": null,
        "line2": null,
        "postal_code": null,
        "state": null
      },
      "invoice_settings": {
        "default_payment_method": "01K688H80Z3199KETHDJ4ZAFPS"
      },
      "id": "string"
    }
  ],
  "last_key": null
}

List of customers