---
page_title: List all customers
product: LotusPay
platform: Web
page_source: https://juspay.io/in/docs/lotuspay/web/core-resources/list-all-customers
openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Flotuspay%2Fweb%2Fcore-resources%2Flist-all-customers
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/lotuspay/llms.txt
---

## API Version: default


# List all customers



You can see a list of your customers. The customers are returned sorted by creation date, with the most recent appearing first. You can use this API method and the limit parameter to page through customers.

**ARGUMENTS** 


| Argument | Description |
|---|---|
| limit optional, default is 100 | A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 100. |
| page optional | This will return all the customer within the page. |


**Returns**  A dictionary with a `data` property that contains an array of up to `limit` customers  and when you pass `page`  it will return you all the entries in the respective page.Passing an optional `email` will result in filtering to customers with only that exact email address. Each entry in the array is a separate customer object. If no more customers are available, the resulting array will be empty. If you provide a non-existent `email`, this call returns an error.## Endpoints:
- Sandbox: https://api-test.lotuspay.com/v1/customers

- Production: https://api.lotuspay.com/v1/customers

## Request Type: 
GET

## Content-Type: 
application/json

## Authorization:

#### Basic Auth:
Auth example
- Value:  sk_test_XjIHowXWSI23uvjepz2X82
## Sample Code Snippets:
### Sample Request and Response:

#### Request:
```Shell
$ curl https://api-test.lotuspay.com/v1/customers?limit=6 \
   -u sk_test_XjIHowXWSI23uvjepz2X82: \
   -G
```

#### Response:
```json
{
    "object": "list",
    "url": "/v1/customers",
    "has_more": false,
    "data": [
          {
              "id": "CU004433221AA"
          },
          {
              "id": "CU004433221BB"
          },
          {
              "id": "CU004433221CC"
          },
          {
              "id": "CU004433221DD"
          }
    ]
  }
```

## API Responses:


---

## See Also

- [Retrieve a customer](https://juspay.io/in/docs/lotuspay/web/core-resources/retrieve-a-customer)
- [The bank account object](https://juspay.io/in/docs/lotuspay/web/core-resources/the-bank-account-object)